【身份证号码归属地接口】技术文档
服务特点：
- 支持15位和18位身份证号码解析
- 提供完整的归属地信息
- 包含生肖、星座等扩展信息
使用流程：
1. 点击"API服务申请"按钮提交使用申请
2. 审核通过后获取专属接口地址和访问密钥
3. 按照技术文档集成到您的合规业务系统中
服务申请或技术咨询请API服务申请
- 支持15位和18位身份证号码解析
- 提供完整的归属地信息
- 包含生肖、星座等扩展信息
使用流程：
1. 点击"API服务申请"按钮提交使用申请
2. 审核通过后获取专属接口地址和访问密钥
3. 按照技术文档集成到您的合规业务系统中
服务申请或技术咨询请API服务申请
接口地址：审核通过后提供
功能描述：该接口可用于查询身份证号码的归属地信息
请求方式：POST
参数类型：application/json
请求参数：
| 请求参数 | 参数类型 | 描述 | 示例 |
| key | string | 访问密钥(由平台审核通过后提供) | cade57672df9a790ff1e2c686bba13ac |
| data | string | 通过AES-ECB加密过后的字符串 | 请求参数：5841322f0be754b04296977e03b793ca 原文：110105199001011234 需要通过AES加密 AES密钥就是：客服提供的请求API密钥(key)的前16位 算法：AES 模式：ECB 填充：PKCS5Padding 数据块：128位 输出结果：Hex 输出编码：UTF-8 可以通过《AES加密解密工具》在线工具调试 |
| t | long | 当前13位时间戳 | 1704038400000 |
| sign | string | 安全签名（md5(key+t)） | cade57672df9a790ff1e2c686bba13ac |
请求示例
{
"data": "5841322f0be754b04296977e03b793ca",
"t": 1768298034079,
"sign": "09b3b4cef96907ff7a250ed78b242169",
"key": "d8f135a882348e0345478d11d84161e2"
}
安全说明：
sign：安全签名 由key+t拼接后进行标准哈希处理
key：cade57672df9a790ff1e2c686bba13ac
t：1704038400000
string str = cade57672df9a790ff1e2c686bba13ac1704038400000
string sign = md5(str)
最终签名结果：7e11f0d182475f219cecb6965025a7e8
t：1704038400000
string str = cade57672df9a790ff1e2c686bba13ac1704038400000
string sign = md5(str)
最终签名结果：7e11f0d182475f219cecb6965025a7e8
返回结果：
| 参数 | 参数类型 | 描述 | 示例 |
| code | int | 状态码 200表示成功 其它表示异常 | 200 |
| msg | string | 返回信息描述 | 操作成功 |
| data | object | 响应数据对象 code=200才返回 其它为null 《详情：下方data对象》 | null |
data对象结构：
| 参数 | 参数类型 | 描述 | 示例 |
| id_card | string | 请求时的加密身份证号码 | 5841322f0be754b04296977e03b793ca |
| gender | string | 性别 | 男 |
| birthday | string | 出生日期 | 1990-01-01 |
| age | int | 年龄 | 34 |
| province | string | 所属省份 | 北京市 |
| city | string | 所属城市 | 北京市 |
| district | string | 所属区县 | 朝阳区 |
| chineseZodiac | string | 生肖 | 蛇 |
| zodiac | string | 星座 | 摩羯座 |
| available_token | int | 剩余可用查询次数 | 800 |
| msg参数 | 描述 |
| 请求参数不合法 | 参数格式或值不符合要求，请检查key|data|t|sign参数 |
| 请求签名不正确 | 安全签名验证失败，请检查签名生成方式 |
| 请求接口请保持网络畅通 | 网络连接异常，请检查网络状态 |
| 身份证号码为15位或18位 | 输入的身份证号码位数不正确 |
| 身份证号码校验失败 | 身份证号码不符合校验规则 |
返回示例
成功响应
{
"code": 200,
"msg": "成功",
"data": {
"id_card": "5841322f0be754b04296977e03b793ca",
"gender": "男",
"birthday": "1990-01-01",
"age": 34,
"province": "北京市",
"city": "北京市",
"district": "朝阳区",
"chineseZodiac": "蛇",
"zodiac": "摩羯座",
"available_token": 800
}
}
异常响应
{
"code": 500,
"msg": "无效访问密钥",
"data": null
}