• 66
  • 4257
  • 164

邮编查询

聚合数据 免费 支持HTTPS

提供全国邮政编码大全,为你快速准确查邮编

  • 免费会员100次/天
  • 高级会员500次/天
  • 钻石会员无限次/天

免费 (根据会员等级不同,每日可调用次数不同)

  • API文档
  • 错误码参照
  • 示例代码
  • 联系我们
立即调用
接口地址:http://v.juhe.cn/postcode/search
返回格式:json/xml
请求方式:http get/post
请求示例:http://v.juhe.cn/postcode/search.php?key=您申请的KEY&pid=15&cid=205&did=2125&q=
接口备注:根据相关条件查询符合条件地区的邮编

请求参数说明:

名称 必填 类型 说明
  pid int 省份ID
  cid int 城市ID
  did int 区域ID
  q string 地名关键字,如:木渎
  page int 第几页,默认为第1页
  pagesize int 每页显示条数,(1-50)默认20条,
  key string 在个人中心->我的数据,接口名称上方查看
  dtype string 返回数据的格式,xml或json,默认json

返回参数说明:

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

JSON返回示例:

{
    "reason": "successed",
    "result": {
        "list": [
            {
                "PostNumber": "215101",
                "Province": "江苏省",
                "City": "苏州市",
                "District": "吴中区",
                "Address": "木渎镇木东路"
            },
            {
                "PostNumber": "215127",
                "Province": "江苏省",
                "City": "苏州市",
                "District": "吴中区",
                "Address": "甪直镇西汇上塘街香花弄"
            },
            {
                "PostNumber": "215101",
                "Province": "江苏省",
                "City": "苏州市",
                "District": "吴中区",
                "Address": "木渎镇迎号弄"
            },
            {
                "PostNumber": "215127",
                "Province": "江苏省",
                "City": "苏州市",
                "District": "吴中区",
                "Address": "甪直镇中兴路"
            },
            {
                "PostNumber": "215168",
                "Province": "江苏省",
                "City": "苏州市",
                "District": "吴中区",
                "Address": "旺吴路"
            },
            {
                "PostNumber": "215101",
                "Province": "江苏省",
                "City": "苏州市",
                "District": "吴中区",
                "Address": "木渎镇邾巷弄"
            },
            {
                "PostNumber": "215101",
                "Province": "江苏省",
                "City": "苏州市",
                "District": "吴中区",
                "Address": "木渎镇老园上"
            },
            {
                "PostNumber": "215111",
                "Province": "江苏省",
                "City": "苏州市",
                "District": "吴中区",
                "Address": "金庭镇堂里街"
            },
            {
                "PostNumber": "215103",
                "Province": "江苏省",
                "City": "苏州市",
                "District": "吴中区",
                "Address": "横泾街道中街弄"
            },
            {
                "PostNumber": "215127",
                "Province": "江苏省",
                "City": "苏州市",
                "District": "吴中区",
                "Address": "甪直镇彩虹路"
            },
            {
                "PostNumber": "215124",
                "Province": "江苏省",
                "City": "苏州市",
                "District": "吴中区",
                "Address": "郭巷街道郭新西路"
            },
            {
                "PostNumber": "215127",
                "Province": "江苏省",
                "City": "苏州市",
                "District": "吴中区",
                "Address": "甪直镇东方大道"
            },
            {
                "PostNumber": "215164",
                "Province": "江苏省",
                "City": "苏州市",
                "District": "吴中区",
                "Address": "胥口镇香泾路"
            },
            {
                "PostNumber": "215124",
                "Province": "江苏省",
                "City": "苏州市",
                "District": "吴中区",
                "Address": "郭巷街道尹中路"
            },
            {
                "PostNumber": "215101",
                "Province": "江苏省",
                "City": "苏州市",
                "District": "吴中区",
                "Address": "木渎镇仓基路"
            },
            {
                "PostNumber": "215164",
                "Province": "江苏省",
                "City": "苏州市",
                "District": "吴中区",
                "Address": "太湖度假区湖滨路"
            },
            {
                "PostNumber": "215107",
                "Province": "江苏省",
                "City": "苏州市",
                "District": "吴中区",
                "Address": "东山镇启园路谈家弄"
            },
            {
                "PostNumber": "215128",
                "Province": "江苏省",
                "City": "苏州市",
                "District": "吴中区",
                "Address": "水香五村"
            },
            {
                "PostNumber": "215101",
                "Province": "江苏省",
                "City": "苏州市",
                "District": "吴中区",
                "Address": "花苑东路"
            },
            {
                "PostNumber": "215159",
                "Province": "江苏省",
                "City": "苏州市",
                "District": "吴中区",
                "Address": "光福镇小巨角"
            }
        ],
        "totalcount": 671,
        "totalpage": 34,
        "currentpage": 1,
        "pagesize": 20
    },
    "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/1539784352

联系我们

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

猜你喜欢

现在注册,百款接口免费测试

免费注册