申请次数：49
邮编查询
免费商品支持https
提供全国邮政编码大全,为你快速准确查邮编
限个人实名用户使用
限企业实名用户使用
50次/天
邮编查询API接口全国30多个省市县的邮编号码查询，数据权威准确，数百万条数据，精确到区、县、街道。支持按模糊地址、指定区域地址查询邮编。
优势
安全
- 稳定
- 合规
安全
邮编查询调用
成为开发者
创建应用
免费试用/测试
参照API文档
购买服务
接口授权
快速调用
完成开发
- 城市区域列表
- 邮编查询地名
- 地名查邮编
- 接口地址：https://v.apiopt.com/api/v1/traffic/location/zip/area/list
- 返回格式：json
- 请求方式：get post
- 请求示例：https://v.apiopt.com/api/v1/traffic/location/zip/area/list?api_key=你申请的api_key&fcode=130000
- 接口备注：
请求Header：
| 名称 | 值 | ||
|---|---|---|---|
| Content-Type | application/x-www-form-urlencoded | ||
| Token | 在个人中心查看Token |
请求参数说明：
| 名称 | 必填 | 类型 | 说明 | ||
|---|---|---|---|---|---|
| api_key | 是 | string | 在个人中心->我的API查看 | ||
| fcode | 否 | string | 上级地区code码（如：140000），不传则为一级地区 |
返回参数说明：
| 名称 | 类型 | 说明 | ||
|---|---|---|---|---|
| code | string | 网关返回码 | ||
| msg | string | 网关返回码描述 | ||
| sub_code | string | 业务返回码 | ||
| sub_msg | string | 业务返回码描述 | ||
| result | string | 返回内容 | ||
| result.area | array | 区域列表 | ||
| result.area.code | string | 地区代码 | ||
| result.area.name | string | 地区名称 | ||
| result.area.parent_code | string | 父级地区代码 | ||
| result.area.level | int | 地区层级 |
JSON返回示例：
{
"code": 10000,
"msg": "success",
"sub_code": 50000,
"sub_msg": "success",
"result": {
"area": [
{
"code": "120102001",
"name": "大王庄街道",
"parent_code": "120102",
"level": 4
},
{
"code": "120102002",
"name": "大直沽街道",
"parent_code": "120102",
"level": 4
},
{
"code": "120102003",
"name": "中山门街道",
"parent_code": "120102",
"level": 4
},
{
"code": "120102004",
"name": "富民路街道",
"parent_code": "120102",
"level": 4
},
{
"code": "120102005",
"name": "二号桥街道",
"parent_code": "120102",
"level": 4
},
{
"code": "120102006",
"name": "春华街道",
"parent_code": "120102",
"level": 4
},
{
"code": "120102007",
"name": "唐家口街道",
"parent_code": "120102",
"level": 4
},
{
"code": "120102008",
"name": "向阳楼街道",
"parent_code": "120102",
"level": 4
},
{
"code": "120102009",
"name": "常州道街道",
"parent_code": "120102",
"level": 4
},
{
"code": "120102010",
"name": "上杭路街道",
"parent_code": "120102",
"level": 4
},
{
"code": "120102011",
"name": "东新街道",
"parent_code": "120102",
"level": 4
},
{
"code": "120102012",
"name": "鲁山道街道",
"parent_code": "120102",
"level": 4
},
{
"code": "120102013",
"name": "天津铁厂街道",
"parent_code": "120102",
"level": 4
}
]
}
}业务错误码：
| 错误码 | 说明 | ||
|---|---|---|---|
| 512102 | 必须传市及以下地区代码 |
网关错误码：
| 错误码 | 说明 | ||
|---|---|---|---|
| 10001 | 错误的KEY | ||
| 10002 | 缺少api_key参数 | ||
| 10003 | 您的KEY被禁止 | ||
| 10005 | 您的IP被禁止 | ||
| 10006 | 未知的请求 | ||
| 10007 | 当前IP请求超过限制 | ||
| 10008 | 请求的服务超过次数限制 | ||
| 10009 | 系统繁忙,请稍后重试 | ||
| 10010 | 接口在维护 | ||
| 10011 | 接口已下架 | ||
| 10012 | 请求的服务未找到 | ||
| 10013 | KEY缓存已过期 | ||
| 10014 | 业务参数不合法 | ||
| 10015 | TOKEN不存在 | ||
| 10016 | TOKEN不合法 | ||
| 10017 | 账号被停用 | ||
| 20001 | 系统内部异常 | ||
| 20002 | 业务处理失败 |
