全国行政区划查询

查询中国大陆省级、市/州、区/县三级行政区划；支持列表、联动、名称搜索、详情与完整树。本地快照数据，不代表实时官方公告；覆盖31个省级地区，不含港澳台。

接口地址

请求方式POST / JSON

身份认证Bearer API Key

所属分类数据查询

调用费用免费

包月要求不强制包月

调用限制不限

补充说明

POST /api/v1/endpoints/china-regions，Bearer API Key；action=provinces/children/search/detail/tree；行政区划信息为快照，非实时政府发布数据。

请求参数

除 Bearer API Key 请求头外，使用 application/json 发送以下字段。图片接口的文件需先转成纯 Base64 字符串提交。

字段名称	格式	说明
`action`	字符串	可选，默认省列表；支持下级、搜索、详情或树
`parent_code`	字符串	children 模式必填，例如 44
`parent_level`	字符串	children 时可指定，1省、2市
`code`	字符串	detail 模式必填
`keyword`	字符串	search 模式必填
`level`	字符串	可选
`depth`	字符串	tree 模式使用
`limit`	数字	search 模式使用，1–50

非预期参数将被忽略；非法参数 HTTP 422。接口执行异常统一返回失败响应，不计为成功扣点。请仅提交您有权处理的文本、图片或网页内容。

示例代码

将密钥和业务字段替换为自己的实际值，不要在公开网页或 App 内写入管理员密钥。

cURL

curl -X POST "https://api.dcykjgw.com/api/v1/endpoints/china-regions" \
  -H "Authorization: Bearer dcy_你的完整密钥" \
  -H "Content-Type: application/json" \
  -d '{"action":"children","parent_code":"44","parent_level":1}'

JavaScript

fetch('https://api.dcykjgw.com/api/v1/endpoints/china-regions', {
  method: 'POST',
  headers: {'Content-Type':'application/json','Authorization':'Bearer dcy_你的完整密钥'},
  body: JSON.stringify({"action":"children","parent_code":"44","parent_level":1})
}).then(r => r.json()).then(console.log);

响应结构

{
  "code": 0,
  "msg": "处理成功",
  "platform": "china-regions",
  "data": {
    "source_version": "cn-division-2026",
    "coverage": "中国大陆31个省级单位",
    "is_realtime": false,
    "parent": {"code":"44","name":"广东省","level":1,"parent_code":null},
    "total": 2,
    "list": [
      {"code":"4401","name":"广州市","level":2,"parent_code":"44"},
      {"code":"4403","name":"深圳市","level":2,"parent_code":"44"}
    ]
  }
}

以上仅展示部分地区。action=tree 返回 data.tree；action=detail 返回 data.region 和 data.path。部分省直管节点同一编码可能存在于两个层级，建议显式提供 level / parent_level。所有代码以字符串处理，数据非实时，港澳台暂未覆盖。

返回参数说明

字段	格式	说明
`code`	数字	业务状态码，0 表示本次接口调用成功；非 0 时结合 msg 和 HTTP 状态码排查。
`msg`	字符串	本次请求结果说明，成功时描述处理结果，失败时给出可读错误原因。
`platform`	字符串	当前接口/平台标识，成功响应中用于区分具体接口来源。
`data`	对象	接口业务数据；具体字段含义见下方本接口字段说明。
`data.source_version`	字符串	行政区划快照版本。
`data.coverage`	字符串	当前数据覆盖范围。
`data.is_realtime`	布尔值	是否实时数据。
`data.parent / data.region`	对象	children/detail 模式下的父地区或当前地区信息。
`data.list`	对象数组	省份、下级地区或搜索结果列表。
`data.path`	对象数组	detail 模式下从省到当前地区的层级路径。
`data.tree`	对象数组	tree 模式返回的省市区层级树。
`data.total`	数字	当前返回节点数量。
`data.has_more`	布尔值	搜索结果是否还有更多匹配项。

无效参数 HTTP 422；无效密钥 401；权限限制 403；点数不足 402；频率超限 429；服务暂不可用 503。

在线测试 · 全国行政区划查询

请填写自己的 API Key。图片只上传到当前 API 请求，不保存到浏览器本地存储；图片 Base64 在下方结果中自动隐藏。

先输入自己的 API Key，点击“加载省份”；选择省份后自动加载城市，选择城市后自动加载区县。所有请求均使用现有 API 鉴权及费用规则。

响应结果

填写参数后点击“发送测试请求”。