/data/mobile_area
1.接口描述
该API的功能查询手机号属地。
请求方式：
POST
请求URL：
https://cloudapi.deepfinch.com/data/mobile_area
调试工具
2.请求参数
2.1 请求头域
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
| X-DF-API-ID | string | 是 | API调用凭证信息，详细信息请参考API调用 |
| X-DF-API-SECRET | string | 是 | API调用凭证信息，详细信息请参考API调用 |
2.2 请求体
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
| phone_number | string | 是 | 手机号码 |
3.返回参数
正常响应 （200）
| 字段 | 类型 | 描述 |
|---|---|---|
| request_id | string | 本次请求的 id |
| result_code | string | 0: 查询成功 1: 查询失败 2: 查询异常 |
| result_message | string | 查询结果描述 |
| result | object | 查询结果 |
其中result的字段如下：
| 字段 | 类型 | 描述 |
|---|---|---|
| mpn | string | 手机号段 |
| prov | string | 省份 |
| pref | string | 城市 |
| carrier | string | 运营商 |
| area_code | string | 区号 |
| postcode | string | 邮编 |
| idn | string | 区划代码 |
输出示例：
{
"request_id": "TID90a5f079a2a348d895e4b95e997ac5c7",
"result": {
"area_code": "010",
"carrier": "中国移动",
"idn": "110100",
"mpn": "1871119",
"postcode": "100000",
"pref": "北京",
"prov": "北京"
},
"result_code": 0,
"result_message": "查询成功",
"status": "OK"
}
4.错误码
| 状态码 | status 字段 |
说明 |
|---|---|---|
400 |
INVALID_ARGUMENT | 请求参数错误 |
400 |
QUERY_FAILED | 查询失败 |
401 |
UNAUTHORIZED | 未授权或授权失败 |
403 |
RATE_LIMIT_EXCEEDED | 调用频率超出限额 |
404 |
NOT_FOUND | 请求路径错误 |
500 |
INTERNAL_ERROR | 服务器内部错误 |
输出示例：
{
"status": "RATE_LIMIT_EXCEEDED",
"request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e"
}