邮编查询数据接口_免费API接口调用-聚合数据

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

返回格式：json/xml

请求方式：http get/post

请求示例：http://v.juhe.cn/postcode/query?postcode=215001&key=申请的KEY

接口备注：通过邮编查询对应的地名

请求参数说明：

名称	必填	类型	说明
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)	具体错误代码

完整教学代码示例：

	语言	标题	提供者	时间

常见问题：

	内容	详细
	常见问题:	http://www.juhe.cn/qa/index/1524400783

联系我们

	内容	详细
	接口测试:	API测试工具
	技术支持:	info@juhe.cn
	联系电话:	400-8827-715
	在线客服QQ:	800076065

邮编查询

猜你喜欢