行政区划信息批量数据查询

接口描述:

  • 行政区划信息批量数据查询 用于查询行政区划编码对应的名称

接口地址:

请求方式:

  • POST

请求头:

参数名称 参数说明 请求类型 是否必须 数据类型
X-App-Id 客户端 clientId header true string

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型
Array 行政区划编码(最长十条数据) body true Array

响应状态

状态码 说明
200 OK
1007 查询参数区域编码长度超过限制,最多为10条数据

其他状态码参见:全局状态码

请求示例

[
    "331024209233", 
    "331024210200"
]

响应示例:

正确时返回:

{
    "code": 200,
    "status": "success",
    "message": "请求成功",
    "data": [
        {
            "code": "331024209233",
            "name": "温泉村委会"
        },
        {
            "code": "331024210200",
            "name": "公平村委会"
        }
    ]
}

错误时返回:

{
    "code": 1007,
    "status": "error",
    "message": "查询参数区域编码长度超过限制,最多为10条数据"
}

响应参数:

参数名称 参数说明 类型 schema
code 成功或异常编码 integer(int32) integer(int32)
data 成功或异常数据 string
message 成功或异常消息 string
status 旧接口成功、失败或异常辅助判断标记:success、fail、error,可用值:success,fail,error string

调用示例:

NodeJs - Axios:

const axios = require('axios');
let data = JSON.stringify([
  "您的查询编码"
]);

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://api_server_url/area/getAreaList?accessToken={请填入您的token}',
  headers: { 
    'Content-Type': 'application/json'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});


Java - OkHttp 示例:

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "[\n    \"您的查询编码\"\n]");
Request request = new Request.Builder()
  .url("https://api_server_url/area/getAreaList?accessToken={请填入您的token}")
  .method("POST", body)
  .addHeader("Content-Type", "application/json")
  .build();
Response response = client.newCall(request).execute();

Curl 示例:

curl --location 'https://api_server_url/area/getAreaList?accessToken={请填入您的token}' \
--header 'Content-Type: application/json' \\
--data '[
    "您的查询编码"
]'
作者:杭州天音  创建时间:2023-08-08 10:48
最后编辑:杭州天音  更新时间:2025-08-22 15:44