行政区划查询接口（region.query）：省 / 市 / 区县三级数据与邮编

这个接口能解决什么问题

地址是绝大多数业务系统绕不开的基础数据：省市区三级联动、邮编填充、把用户手填的地名标准化成规范的行政区划代码（adcode）。region.query 把这些整理好的国家统计局行政区划与邮政编码数据通过一个简单接口开放出来，省去自己维护一张庞大且经常变动的行政区划表的麻烦。

一句话说明

region.query 返回省 / 市 / 区县三级名称、行政区划代码（adcode，6 位）与邮政编码，数据源每周日凌晨全量同步一次（新增插入、变更更新、源数据移除逻辑删除），可放心用于生产。

适用场景

省市区三级联动下拉：前端地址选择器直接拉取
地址解析与标准化：把用户填写的「重庆市巴南区」规范成名称 + adcode
邮政编码填充：根据区县返回邮编
行政区划代码转换：6 位 adcode 与名称互查
报表区域归类：按 adcode 做区域维度的统计分组

接口规格

接口规格
请求地址	`https://api.xujian.tech/openapi/region/query`
请求方式	GET
鉴权方式	请求头 `X-API-Key`
接口编码	`region.query`
收费类型	免费（FREE，0 元，不扣费）
响应格式	JSON，`application/json（charset=UTF-8）`
典型用途	三级联动、地址标准化、邮编填充、adcode 转换

如何调用

按行政区划代码精确查询：

cURL

curl -s "https://api.xujian.tech/openapi/region/query?code=110101" -H "X-API-Key: 你的APIKey"

查询全部省份（level=1）

cURL

curl -s "https://api.xujian.tech/openapi/region/query?level=1" -H "X-API-Key: 你的APIKey"

返回示例（code = 0）

JSON

{
  "code": 0,
  "msg": "success",
  "data": {
    "code": "110101",
    "name": "东城区",
    "level": 3,
    "parentCode": "110100",
    "parentName": "北京市市辖区",
    "zipCode": "100010",
    "pinyin": "dongchengqu",
    "apiCode": "region.query",
    "apiName": "行政区划查询",
    "chargeType": "FREE",
    "balance": 100.0000,
    "costMs": 20
  }
}

计费说明

完全免费。有可用的 X-API-Key 即可调用，不扣费、不消耗余额，适合作为地址类业务的基础设施。

常见问题

数据多久更新一次？ 每周日 03:00 全量同步，也支持在管理端手动触发。
怎么区分省 / 市 / 区县？ 用返回的 level 字段（1 省、2 市、3 区县）。
直辖市怎么处理？ 北京 / 上海 / 天津 / 重庆的市级与区级层级同样规范，adcode 可直接用于地址解析与上报。