1. 基本信息
| 接口地址 | https://v1.apizero.cn/api/idcard-region |
|---|
| 请求方法 | GET |
|---|
| 分类 | kyc |
|---|
| 提供方 | 极数本源 |
|---|
| 计费模式 | 免费试用 |
|---|
| 单次消耗 | 0 积分 |
|---|
| 起步价 | — |
|---|
| QPS 限制 | 10 req/s |
|---|
| 每日免费额度 | 100 次（已认证用户） |
|---|
| 匿名每日额度 | 0 次（无 API Key） |
|---|
| VIP 免费 | 否 |
|---|
| 调用次数 | |
|---|
3. 请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|
idcard | string | 是 | 6 位区划代码或 15/18 位身份证号 | 110101 |
5. 请求示例 (cURL)
curl "https://v1.apizero.cn/api/idcard-region?idcard=110101&key=YOUR_API_KEY"
6. 响应字段
| 字段 | 类型 | 说明 | 示例 |
|---|
idcard | string | 号码（>6 位时尾部以 * 脱敏） | — |
province.code | string | 省份代码 | — |
province.name | string | 省份名称 | — |
city.code | string | 城市代码 | — |
city.name | string | 城市名称 | — |
district.code | string | 区县代码（部分老号码可能缺失） | — |
district.name | string | 区县名称 | — |
7. 响应示例
{
"code": 0,
"msg": "成功",
"data": {
"idcard": "110101************",
"province": {
"code": "110000",
"name": "北京市"
},
"city": {
"code": "110100",
"name": "北京市"
},
"district": {
"code": "110101",
"name": "东城区"
}
}
}
8. 错误码
| code | status | 说明 |
|---|
4000 | — | idcard 格式无效（应为 6/15/18 位） |
4000 | — | 未找到该省份/区县数据 |
5020 | — | CDN 上游不可用 |