【手机号归属地接口】技术文档
服务特点：
- 毫秒级查询响应速度
- 完善的API文档和技术支持
使用流程：
1. 点击"API服务申请"按钮提交使用申请
2. 审核通过后获取专属接口地址和访问密钥
3. 按照技术文档集成到您的合规业务系统中
服务申请或技术咨询请API服务申请
- 毫秒级查询响应速度
- 完善的API文档和技术支持
使用流程：
1. 点击"API服务申请"按钮提交使用申请
2. 审核通过后获取专属接口地址和访问密钥
3. 按照技术文档集成到您的合规业务系统中
服务申请或技术咨询请API服务申请
接口地址：审核通过后提供
功能描述：该接口可用于查询手机号归属地信息
请求方式：POST
参数类型：application/json
请求参数：
| 请求参数 | 参数类型 | 描述 | 示例 |
| key | string | 访问密钥(由平台审核通过后提供) | cade57672df9a790ff1e2c686bba13ac |
| data | string | 通过AES-ECB加密过后的字符串 | 请求参数：5841322f0be754b04296977e03b793ca 原文：13000000000 需要通过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对象结构：
| 参数 | 参数类型 | 描述 | 示例 |
| phone | string | 请求时的加密手机号 | 5841322f0be754b04296977e03b793ca |
| province | string | 省份 | 北京 |
| city | string | 城市 | 北京 |
| isp | string | 运营商 | 中国移动 |
| post_code | string | 区号 | 010 |
| city_code | string | 城市编码 | 100000 |
| area_code | string | 区域代码 | 100100 |
| available_token | int | 剩余可用查询次数 | 800 |
| msg参数 | 描述 |
| 请求参数不合法 | 参数格式或值不符合要求，请检查key|data|t|sign参数 |
| 请求签名不正确 | 安全签名验证失败，请检查签名生成方式 |
| 请求接口请保持网络畅通 | 网络连接异常，请检查网络状态 |
返回示例
成功响应
{
"code": 200,
"msg": "成功",
"data": {
"phone": "5841322f0be754b04296977e03b793ca",
"province": "北京",
"city": "北京",
"isp": "中国移动",
"post_code": "010",
"city_code": "100000",
"area_code": "100100",
"available_token": 800
}
}
异常响应
{
"code": 500,
"msg": "无效访问密钥",
"data": null
}