手机二次号查询-联通

1. 调用说明： 请求方式：post服务名称：api_query_mobileDuration_v1参数格式：application/json;charset=UTF-82. 公共请求参数： 字段必须类型说明serviceName是String服务名称accessKey是String商户账号secretKey是String商户秘钥timestamp是Long时间戳businessNo是String商户流水号3. 请求参数： 字段必须类型说明mobile是String手机号encryptType否String加密类型： MD5; SHA256; SM34.请求示例{ "serviceName":"api_query_mobileDuration_v1", "accessKey":"xxx", "timestamp":1602296068483, "businessNo":"602296068483", "secretKey":"xxx", "mobile":"xxx" }5. 响应参数 字段级别必须类型说明status一级是String响应码message一级是String说明data一级是String结果value二级是String[0-3)[3-6)[6-12)[12-24)[24+)；-1（未查得）operator二级否Integer1：移动2：联通3：电信4：广电6. 响应成功示例{ "status":"0000", "message":"请求成功", "data":{ "value":"0-3" }}7. 响应失败示例{ "status":"5000", "message":"数据源异常"}8. 响应码说明status说明0000请求成功3000无效的商户或已禁用3001商户余额不足3002IP受限3003商户没有该API访问权限4000查询参数异常4001时间戳无效4002商号入参流水号无效4004相同键请求过于频繁4005产品调用超限4010查询参数异常：身份证格式错误4011查询参数异常：姓名格式错误4012查询参数异常：不支持的手机号4013查询参数异常：银行卡格式错误5000数据源异常

1. Request Instructions: Request method: POST; Service name: api_query_mobileDuration_v1; Parameter format: application/json;charset=UTF-8
2. Public Request Parameters:
| Field | Required | Type | Description |
|---|---|---|---|
| serviceName | Yes | String | Service name |
| accessKey | Yes | String | Merchant account |
| secretKey | Yes | String | Merchant secret key |
| timestamp | Yes | Long | Timestamp |
| businessNo | Yes | String | Merchant serial number |
3. Request Parameters:
| Field | Required | Type | Description |
|---|---|---|---|
| mobile | Yes | String | Mobile phone number |
| encryptType | No | String | Encryption type: MD5; SHA256; SM3 |
4. Request Example: { "serviceName":"api_query_mobileDuration_v1", "accessKey":"xxx", "timestamp":1602296068483, "businessNo":"602296068483", "secretKey":"xxx", "mobile":"xxx" }
5. Response Parameters:
First-level fields:
| Field | Required | Type | Description |
|---|---|---|---|
| status | Yes | String | Response code |
| message | Yes | String | Explanation |
| data | Yes | String | Response result |
Second-level fields (under data):
| Field | Required | Type | Description |
|---|---|---|---|
| value | No | String | Valid ranges: [0-3), [3-6), [6-12), [12-24), [24+); -1 (no record found) |
| operator | No | Integer | 1: China Mobile; 2: China Unicom; 3: China Telecom; 4: China Broadcast Network |
6. Successful Response Example: { "status":"0000", "message":"Request successful", "data":{ "value":"0-3" } }
7. Failed Response Example: { "status":"5000", "message":"Data source exception" }
8. Response Code Explanation:
| Status Code | Description |
|---|---|
| 0000 | Request successful |
| 3000 | Invalid merchant or merchant disabled |
| 3001 | Insufficient merchant balance |
| 3002 | IP restricted |
| 3003 | Merchant has no access permission to this API |
| 4000 | Abnormal query parameters |
| 4001 | Invalid timestamp |
| 4002 | Invalid merchant serial number in request parameters |
| 4004 | Duplicate requests sent too frequently |
| 4005 | Product call limit exceeded |
| 4010 | Abnormal query parameters: incorrect ID card format |
| 4011 | Abnormal query parameters: incorrect name format |
| 4012 | Abnormal query parameters: unsupported mobile phone number |
| 4013 | Abnormal query parameters: incorrect bank card format |
| 5000 | Data source exception |

搜集汇总

背景与挑战

背景概述

该数据集提供了联通手机二次号查询API的详细调用指南，涵盖请求与响应参数、示例及状态码说明，适用于需要查询手机号使用时长（如0-3个月、3-6个月等区间）的开发场景。