根据身份证号查询归属地
返回首页
身份证归属地查询
请求示例
curl -X POST https://api.zhuimengapi.com/api/v1/idcard_area_query \
-H "X-API-Key: RPA-xxxxxxxx"
-d "idcard=your_idcard"import requests
url = "https://api.zhuimengapi.com/api/v1/idcard_area_query"
headers = {"X-API-Key": "RPA-xxxxxxxx"}
data = {
"idcard": "your_idcard"
}
res = requests.post(url, data=data, headers=headers)
print(res.json())const axios = require('axios');
axios.post("https://api.zhuimengapi.com/api/v1/idcard_area_query", {
idcard: "your_idcard"
}, {
headers: { "X-API-Key": "RPA-xxxxxxxx" }
}).then(res => console.log(res.data));响应示例
{
"code": 0,
"msg": "返回码对应的说明",
"success": false,
"taskNo": "本次聚美查询任务号；成功响应中返回",
"charge": false,
"data": {
"areaCode": "身份证归属地行政区划代码",
"areaName": "身份证归属地名称"
}
}
接口信息
请求地址
https://api.zhuimengapi.com/api/v1/idcard_area_query
请求方式
POST
Content-Type
application/x-www-form-urlencoded
鉴权方式
X-API-Key: RPA-xxxxxxxx
请求参数
idcard
String
必填 18 位身份证号码
返回字段
code
Integer
统一返回码，`200` 表示请求成功
msg
String
返回码对应的说明
success
Boolean
是否调用成功；成功响应中返回
taskNo
String
本次聚美查询任务号；成功响应中返回
charge
Boolean
是否计费；成功响应中返回
data
Object
查询结果对象；成功响应中返回
areaCode
String
身份证归属地行政区划代码
areaName
String
身份证归属地名称
响应状态说明
不同接口的成功返回字段可能不同，请以本接口的响应示例和实际结果为准。请求失败时使用下方统一错误结构，失败调用不计费。
- 200 请求成功返回字段以本接口的响应示例和实际结果为准，部分接口不包含 code 字段。 按接口规则计费
- 400 参数或业务错误请求参数无效时返回安全、明确的修正提示。 不扣费
- 401 API Key 无效密钥缺失、格式错误、无效或已经过期。 不扣费
- 402 账户余额不足请充值后重试；本次请求不会进入接口处理。 不扣费
- 403 访问被拒绝IP 规则限制，或当前账户无权调用仅限 VIP 的接口。 不扣费
- 404 接口路由不存在请检查请求地址中的 API 路由是否正确。 不扣费
- 405 请求方法不支持请按照接口文档使用允许的 GET 或 POST 方法，并查看 Allow 响应头。 不扣费
- 413 请求体过大单次请求最大允许 20MB。 不扣费
- 429 请求频率超限请根据 Retry-After 响应头稍后重试。 不扣费
- 500 系统服务异常请稍后重试；持续出现时请向技术支持提供 request_id。 不扣费
- 502 接口服务暂时不可用接口处理异常或暂时不可用，请稍后重试。 不扣费
- 503 系统服务暂时不可用服务正在恢复，请稍后重试。 不扣费
错误响应示例
使用 request_id 查询对应调用日志
{
"code": 400,
"message": "请输入有效的身份证号码",
"data": null,
"request_id": "1-xxxxxxxx",
"time": "2026-07-29 12:00:00"
}
请求地址
https://api.zhuimengapi.com/api/v1/idcard_area_query
请求方式
POST
Content-Type
application/x-www-form-urlencoded
鉴权 Header
X-API-Key
Params
GET 请求只通过 URL 查询参数发送
Body 表单模式
POST + application/x-www-form-urlencoded 使用表单键值对请求体
快速信息
| 接口路由 | idcard_area_query |
| 接口分类 | 身份核验 |
| 请求方式 | POST |
| 计费方式 | 1 积分/次（约 ¥0.05/次） |
| 频率限制 | 不限制 |
| 认证方式 | X-API-Key |
| 接口提供 | 官方接口 |