- API
- 错误码参照
- 价格与请求限制
- 示例代码
- 其他相关
接口地址：http://v.juhe.cn/postcode/query
支持格式：json/xml
请求方式：http get/post
请求示例：http://v.juhe.cn/postcode/query?postcode=215001&key=申请的KEY
接口备注：通过邮编查询对应的地名
调用样例及调试工具：API测试工具
请求参数说明：
| 名称 | 类型 | 必填 | 说明 | |
|---|---|---|---|---|
| postcode | string | 是 | 邮编，如：215001 | |
| key | string | 是 | 应用APPKEY(应用详细页查询) | |
| page | int | 否 | 页数，默认1 | |
| pagesize | int | 否 | 每页返回，默认:20,最大不超过50 | |
| dtype | string | 否 | 返回数据的格式,xml或json，默认json |
返回参数说明：
| 名称 | 类型 | 说明 | |
|---|---|---|---|
| error_code | int | 返回码 | |
| reason | string | 返回说明 |
JSON返回示例：
{
"reason": "successed",
"result": {
"list": [
{
"PostNumber": "215001",
"Province": "江苏省",
"City": "苏州市",
"District": "平江区",
"Address": "廖家巷新光里"
},
{
"PostNumber": "215001",
"Province": "江苏省",
"City": "苏州市",
"District": "平江区",
"Address": "龙兴桥顺德里"
}
],
"totalcount": 352,
"totalpage": 176,
"currentpage": 1,
"pagesize": "2"
},
"error_code": 0
}
服务级错误码参照(error_code)：
| 错误码 | 说明 | |
|---|---|---|
| 206601 | 错误的邮编号码 | |
| 206602 | 错误的省份ID | |
| 206603 | 错误的城市ID | |
| 206604 | 错误的地区ID |
系统级错误码参照：
| 错误码 | 说明 | 旧版本（resultcode） | |
|---|---|---|---|
| 10001 | 错误的请求KEY | 101 | |
| 10002 | 该KEY无请求权限 | 102 | |
| 10003 | KEY过期 | 103 | |
| 10004 | 错误的OPENID | 104 | |
| 10005 | 应用未审核超时，请提交认证 | 105 | |
| 10007 | 未知的请求源 | 107 | |
| 10008 | 被禁止的IP | 108 | |
| 10009 | 被禁止的KEY | 109 | |
| 10011 | 当前IP请求超过限制 | 111 | |
| 10012 | 请求超过次数限制 | 112 | |
| 10013 | 测试KEY超过请求限制 | 113 | |
| 10014 | 系统内部异常(调用充值类业务时，请务必联系客服或通过订单查询接口检测订单，避免造成损失) | 114 | |
| 10020 | 接口维护 | 120 | |
| 10021 | 接口停用 | 121 |
错误码格式说明（示例：200201）：
| 2 | 002 | 01 | |
|---|---|---|---|
| 服务级错误（1为系统级错误） | 服务模块代码(即数据ID) | 具体错误代码 |
《邮编查询》资费说明：
| 名称 | 价格 | 次数 | 说明 | |
|---|---|---|---|---|
| 本数据接口免费使用（根据会员等级不同，每日可调用次数不同） | ||||
为什么选择聚合数据？我们来做个比较!
| 购买聚合数据的服务支出 | << | 服务器(600元/月)+带宽(100元/月)+技术人员(6000元/月)+... |
完整教学代码示例：
| 语言 | 标题 | 提供者 | 时间 |
|---|
常见问题：
| 内容 | 详细 | |
|---|---|---|
| 常见问题: | http://www.juhe.cn/qa/index/1498399158 |
