行政区划查询

请求地址：https://openapi.dwo.cc/api/regions

请求方式：get

请求类型：none

接口返回示例

{
  "code": 200,
  "msg": "ok",
  "data": {
    "code": "110000",
    "province": "北京市",
    "city": "北京市",
    "city_type": "直辖市",
    "postcode": "100000",
    "area_code": "010",
    "plate": "京O",
    "note": "北京市公安局专用"
  }
}

秘钥KEY传参

参数名	参数类型	参数示例	参数说明
ckey	string	SJKHJDBBDGGE	支持通过：headers/query/body(x-www)

Query参数

模式	特点	适用场景
极简模式	`?code=` / `?zipcode=`，只返回 `code` + `name`，响应极快	嵌入式、URL 反查、快速取名称
标准模式	`?d=类型&s=内容`，返回完整层级 + 邮编/区号/车牌	需要完整行政区划信息的场景

1. 极简模式

参数	必填	说明	示例
`code`	是	6 位（省/市/县）或 9 位（乡/镇/街道）行政代码	`?code=360423`
`zipcode`	是	6 位数字邮编	`?zipcode=332301`

注意：code 与 zipcode 互斥，同时存在时优先处理 code。

2. 标准模式

参数	必填	说明	示例
`d`	是	查询类型：`addr` / `code` / `phone` / `plate`	`?d=addr`
`s`	是	查询内容	`?s=九江市`

`d` 类型详细说明

类型	功能	`s` 示例
`addr`	中文地址查询	`九江市`、`浙江省西湖区`、`江西省西湖区`
`code`	行政代码或名称查询	`360423`、`石河子`
`phone`	邮编或区号查询	`332000`、`0792`、`010`
`plate`	车牌查询	`京A`、`京O`、`粤Z`

响应结果结构

字段	类型	说明
`code`	string	命中记录的行政代码
`province`	string	省 / 直辖市 / 自治区
`city`	string	地级市 / 直辖市 / 自治州 / 盟
`district`	string	县 / 区 / 县级市 / 旗
`town`	string	镇 / 乡 / 街道
`village`	null	村 / 社区（当前数据库不支持，固定返回 `null`）
`city_type`	string	行政类型，如"地级市"、"县级市"、"市辖区"
`postcode`	string	邮编（市级权威）
`area_code`	string	电话区号
`plate`	string	车牌（市级 → 省级回退）
`note`	string	特殊车牌说明，仅特殊车牌返回

Query

请根据API文档填写参数，二选一参数组只能启用其中一个

启用	参数名	参数值	数据类型	参数说明	操作

Body

Body 类型说明

none：不发送任何Body数据，适用于GET请求或不需要Body的API

from-data：使用multipart/form-data格式发送数据，适用于上传文件或包含多种数据类型的请求

x-www-form-urlencoded：使用application/x-www-form-urlencoded格式发送数据，适用于简单的键值对数据

json：使用application/json格式发送数据，适用于复杂数据结构

xml：使用application/xml格式发送数据，适用于XML格式的API

raw：发送原始文本数据，可自定义Content-Type

请根据API要求选择合适的Body类型，并在下方输入对应格式的数据

接口响应

等待发起...

响应码	说明
200	请求成功
203	秘钥错误或不存在
204	服务器错误
211	接口不存在
212	当前接口已下架
213	当前接口正处于审核期
214	API本地文件不存在，请联系管理员检查
215	管理员设置当前接口必须携带ckey请求！
216	付费接口请携带ckey请求！
217	ckey不存在！
218	当前ckey无权限调用此接口，请将此接口添加到ckey调用能力中后重试！
219	访问频率超过限制！请稍后重试！
220	本地API逻辑错误！请联系管理员检查！
221	状态码与管理员配置的状态码不一致，请联系管理员！
222	禁止访问！请联系管理员 (已被加入黑名单)
223	积分不足！请充值后重试
224	余额不足！请充值后重试
225	您已设置仅白名单ip访问！请将当前ip添加到白名单中