查询省下属市

接口概述

根据省份 ID 获取该省下属的市级行政区划数据，返回结果中的城市 id 可作为新增项目的 location 参数。

请求地址

POST /selectProjectCity/{pid}

请求头

参数	必填	说明
apiKey	是	API 访问凭证

路径参数

参数	类型	必填	说明
pid	String	是	省份 ID，取自查询所有省返回的 id

请求示例

curl -X POST "https://openapi.bangtu-ai.com/openApi/selectProjectCity/330000" \
  -H "apiKey: YOUR_API_KEY"

返回结果

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "id": "330100",
      "name": "杭州市",
      "enOrder": "H",
      "pid": "330000",
      "inspectorLocationList": []
    }
  ],
  "timestamp": 1784533680000
}

返回字段

字段	类型	说明
code	Number	通用响应码，200 表示成功
message	String	响应信息
data	Array	指定省份下属的市级行政区划列表
timestamp	Number	服务端响应时间戳，单位为毫秒

data 元素字段

字段	类型	说明
id	String	行政区划 ID，可作为 location 传入新增项目
name	String	行政区划名称
enOrder	String	排序字母
pid	String	父级 ID，即请求传入的省份 ID
inspectorLocationList	Array	子级行政区划，本接口返回空数组

响应码

code	说明
200	请求成功
500	请求失败

注意事项

• pid 必须为查询所有省返回的真实省份 id，否则查询结果为空。