加载接口文档…
94
累计调用
2446ms
平均响应
100.00%
服务可用性
1,000 次/日
免费额度
访问限制
查看更多方案 →无 Key 调用
每日 300 次 · QPS 1
登录免费
当前方案每日 1,000 次 · QPS 10
黄金会员
每日 50,000 次 · QPS 60
企业会员
每日 1,000,000 次 · QPS 120
文档链接
复制文档地址
https://apizero.cn/aidocs/idcard-region/raw.md接口请求地址
https://v1.apizero.cn/api/idcard-region
接口请求方式
GET
请求参数格式
QUERY STRING
接口返回格式
APPLICATION/JSON
接口请求示例
https://v1.apizero.cn/api/idcard-region?idcard=110101
接口信息备注
需要登录 API Key（kyc 类默认关闭匿名访问）。
请求参数说明
| 名称 | 类型 | 说明 |
|---|---|---|
| idcard | string | 必填 · 6 位区划代码或 15/18 位身份证号 · 示例：110101 |
请求头说明
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。 |
返回字段说明
| 名称 | 类型 | 说明 |
|---|---|---|
| idcard | string | 号码（>6 位时尾部以 * 脱敏） |
| province.code | string | 省份代码 |
| province.name | string | 省份名称 |
| city.code | string | 城市代码 |
| city.name | string | 城市名称 |
| district.code | string | 区县代码（部分老号码可能缺失） |
| district.name | string | 区县名称 |
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn |
返回示例
{
"code": 0,
"msg": "成功",
"data": {
"idcard": "110101************",
"province": {
"code": "110000",
"name": "北京市"
},
"city": {
"code": "110100",
"name": "北京市"
},
"district": {
"code": "110101",
"name": "东城区"
}
},
"tips": "极数本源 · https://apizero.cn"
}免责声明
区划代码基于公开行政区划数据；查询结果不代表对身份证号真伪的判断。