/data/mobile_online_status
1.接口描述
该API的功能是获取手机号的在网状态。
请求方式：
POST
请求URL：
https://cloudapi.deepfinch.com/data/mobile_online_status
调试工具
2.请求参数
2.1 请求头域
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
| X-DF-API-ID | string | 是 | API调用凭证信息，详细信息请参考API调用 |
| X-DF-API-SECRET | string | 是 | API调用凭证信息，详细信息请参考API调用 |
2.2 请求体
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
| phone_number | string | 是 | 手机号码 |
| carrier_type | string | 否 | 运营商类型，不填写默认按照号码段区分 |
3.返回参数
正常响应 （200）
| 字段 | 类型 | 描述 |
|---|---|---|
| request_id | string | 本次请求的 id |
| status | string | 状态。正常为 OK ，其他值表示失败。详见错误码 |
| state | int | 业务状态码 1: 正常 2: 停机 3: 在网不可用 4: 销号/未启用 5: 查无此号 |
| carrier | string | 运营商类型，有则返回 |
计费方式
仅仅当status为OK时计费，其他不计费。
运营商类型
| 字段 | 描述 |
|---|---|
| china_mobile | 中国移动 |
| china_union | 中国联通 |
| china_telecom | 中国电信 |
| other | 未知，不能作为请求参数使用 |
输出示例：
{
"request_id": "TID753a47e34ccf467590370fa23d4eac5f",
"status": "OK",
"state": 1,
"carrier": "china_union",
}
4.错误码
| 状态码 | status 字段 |
说明 |
|---|---|---|
400 |
INVALID_ARGUMENT | 请求参数错误 |
400 |
QUERY_FAILED | 查询失败 |
401 |
UNAUTHORIZED | 未授权或授权失败 |
403 |
RATE_LIMIT_EXCEEDED | 调用频率超出限额 |
404 |
NOT_FOUND | 请求路径错误 |
500 |
INTERNAL_ERROR | 服务器内部错误 |
输出示例：
{
"status": "QUERY_FAILED",
"result_message": "不支持的手机号段验证",
"request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e"
}