您现在的位置是:蓝石榴 > 个人博客 > 数据API

个人博客

邮政编码查询API

2018-11-29数据API 3209
通过邮政编码查询接口可以查询邮编对应的省份,城市,区号等信息。
1.接口描述

【接口名称】邮政编码查询接口

【接口 URL】https://www.lan16.com/api/postCode.html

【接口功能】通过此接口查询邮政编码等信息

【接口类型】HTTPS

【请求方式】GET/POST

【响应格式】JSON

2.请求参数

【deviceid】调用方唯一标示,必填项,deviceid通过申请获取

【timestamp】时间戳,必填项,格式为yyyyMMddHHmmss,例如:20150425194111

【postCode】邮政编码,邮政地址为空时必填

【postName】邮政地址,邮政编码为空时必填

【signature】签名,必填项,signature为MD5(timestamp+keyword+idCardNo),keyword通过申请获取

【请求示例】https://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次,调用示例https://www.lan16.com/postCode.html?postCode=441800

很赞哦!(92)