邮政编码查询API


   作者:蓝石榴    由lan16转载自:蓝石榴    更新于:2018-11-29 20:48    已被浏览:85次


1.接口描述
【接口名称】邮政编码查询接口
【接口 URL】http://www.lan16.com/api/postCode.html
【接口功能】通过此接口查询邮政编码等信息
【接口类型】HTTP
【请求方式】GET/POST
【响应格式】JSON

2.请求参数
【deviceid 】调用方唯一标示,必填项,deviceid通过申请获取
【timestamp】时间戳,必填项,格式为yyyyMMddHHmmss,例如:20150425194111
【postCode 】邮政编码,邮政地址为空时必填
【postName 】邮政地址,邮政编码为空时必填
【signature】签名,必填项,signature为MD5(timestamp+keyword+idCardNo),keyword通过申请获取
【 请求示例】http://www.lan16.com/api/postCode.html?timestamp=20181129221221&deviceid=10000&signature=552beb21d442eb6b4bef00c93241bd07&postCode=510405

3.返回结果
【    code     】返回码,必会返回,0查询成功,1查询失败,2缺少必要参数,3超出接口调用频次限制,99接口鉴权失败
【     msg     】结果描述,必会返回
【 executeTime 】接口执行时间,必会返回,单位毫秒
【postInfoList 】邮政信息列表,postCode邮编,areaCode区号,provinceName省,cityName市,areaName区/县,address地址
【 返 回 示 例 】{"code":"0","msg":"查询成功","postInfoList":[{"postCode":"510405","areaCode":"020","provinceName":"广东省","cityName":"广州市","areaName":"白云区","address":"广东省,广州市,白云区"}],"executeTime":177}

4.备注
1.接口免费使用,可发送邮件至lan16@lan16.com申请获取deviceid和keyword,调用频率可根据需求设定;
2.测试秘钥可用deviceid:10000,keyword:ZXEjow25,可调用频率30次/分钟【示例源码下载】
3.免秘钥链接方式调用,每个ip每天可调用200次,调用示例http://www.lan16.com/postCode.html?postCode=441800

豫ICP备13022176号-2   鄂公网安备 42010602000416号   Copyright © 2013 - 2020 蓝石榴. All Rights Reserved  联系我