覆盖全国 3,200+ 个区县的邮政编码与电话区号双向查询服务，支持按地名、邮编、区号三种方式检索，适用于地址补全、物流分拣、表单校验、CRM 数据清洗等场景。
邮编区号查询 API 通过标准 HTTP GET 请求返回结构化 JSON 数据，支持按地名关键词正向查询、或按邮编/区号反向查询。返回字段涵盖省份、城市、区县、6 位邮政编码、电话区号及经纬度坐标。数据按季度与国家邮政局公示同步更新，接口全程 HTTPS 加密传输，支持高并发调用，可稳定用于表单自动补全与后台数据清洗。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| apikey | string | 是 | 用户身份密钥，在控制台「应用管理」中创建应用后获取。 |
| keyword | string | 否 | 地名关键词，如「杭州」「西湖区」，三个参数至少填一个。 |
| zipcode | string | 否 | 6 位邮政编码，如「310000」，用于反向查询所属区域。 |
| area_code | string | 否 | 电话区号，如「0571」，用于反向查询所属区域。 |
| 字段名 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码，200 表示请求成功，其余见错误码对照表。 |
| msg | string | 状态描述信息。 |
| data.province | string | 所属省份，如浙江省。 |
| data.city | string | 所属城市，如杭州市。 |
| data.district | string | 所属区县，如西湖区。 |
| data.zipcode | string | 邮政编码，如 310000。 |
| data.area_code | string | 电话区号，如 0571。 |
| data.lng | string | 经度坐标。 |
| data.lat | string | 纬度坐标。 |
| data.update_time | string | 数据更新时间，格式 yyyy-MM-dd HH:mm:ss。 |
{
"code": 200,
"msg": "success",
"data": {
"province": "浙江省",
"city": "杭州市",
"district": "西湖区",
"zipcode": "310000",
"area_code": "0571",
"lng": "120.1551",
"lat": "30.2741",
"update_time": "2026-04-01 00:00:00"
}
}