聚合数据

邮编查询

  • 数据类型: 应用开发
  • 接口状态: 正常
  • 已连接App的数量: 5874
  • 描述: 提供全国邮政编码大全,为你快速准确查邮编

接口地址: http://v.juhe.cn/postcode/pcd

支持格式: XML/JSON

请求方式: HTTP GET/POST

请求示例: http://v.juhe.cn/postcode/pcd?key=您申请的KEY

请求参数:

名称 类型 必填 说明
key string 在个人中心->我的数据,接口名称上方查看
dtype string 返回数据的格式,xml或json,默认json

返回字段:

名称 类型 说明
error_code int 返回码
reason string 返回说明

JSON返回示例:

{
"reason":"successed",
"result":[
    {
        "id":"1", /*省份ID*/
        "province":"上海市",  /*省份名称*/
    	"city":[
            {
            	"id":"32",  /*城市ID*/
            	"city":"上海市",  /*城市名称*/
            	"district":[
                    {
                    "id":"798",  /*区域ID*/
                    "district":"南汇区"  /*区域名称*/
                    },
                    {
                    "id":"799",
                    "district":"卢湾区"
                    },
                    {
                    "id":"800",
                    "district":"嘉定区"
                    },
                    {
                    "id":"801",
                    "district":"奉贤区"
                    },
                    {
                    "id":"802",
                    "district":"宝山区"
                    },
                    {
                    "id":"803",
                    "district":"崇明县"
                    },
                    {
                    "id":"804",
                    "district":"徐汇区"
                    },
                    {
                    "id":"805",
                    "district":"普陀区"
                    },
                    {
                    "id":"806",
                    "district":"杨浦区"
                    },
                    {
                    "id":"807",
                    "district":"松江区"
                    },
                    {
                    "id":"808",
                    "district":"浦东新区"
                    },
                    {
                    "id":"809",
                    "district":"虹口区"
                    },
                    {
                    "id":"810",
                    "district":"金山区"
                    },
                    {
                    "id":"811",
                    "district":"长宁区"
                    },
                    {
                    "id":"812",
                    "district":"闵行区"
                    },
                    {
                    "id":"813",
                    "district":"闸北区"
                    },
                    {
                    "id":"814",
                    "district":"青浦区"
                    },
                    {
                    "id":"815",
                    "district":"静安区"
                    },
                    {
                    "id":"816",
                    "district":"黄浦区"
                    }
    		]
    		}
    	]
    }
    ]
}

XML返回示例:


          

备注:返回省份、城市、地区(县)关联的列表

服务级错误码参照(error_code):

错误码 说明
206601 错误的邮编号码
206602 错误的省份ID
206603 错误的城市ID
206604 错误的地区ID

系统级错误码参照:

错误码 说明
10001 错误的请求KEY
10002 该KEY无请求权限
10003 KEY过期
10004 错误的OPENID
10005 应用未审核超时,请提交认证
10007 未知的请求源
10008 被禁止的IP
10009 被禁止的KEY
10011 当前IP请求超过限制
10012 请求超过次数限制
10013 测试KEY超过请求限制
10014 系统内部异常(调用充值类业务时,请务必联系客服或通过订单查询接口检测订单,避免造成损失)
10020 接口维护
10021 接口停用

错误码格式说明(示例:200201):

2 002 01
服务级错误(1为系统级错误) 服务模块代码(即数据ID) 具体错误代码

其他相关内容:

内容 详细
接口测试 API测试工具
技术支持 info@juhe.cn
联系电话 0512-62391880
QQ交流群 264591694
在线客服QQ 1794844675
商务合作QQ 603866358