三要素简版-联通

1. 调用说明： 请求方式：post服务名称：api_verify_mobile_rr参数格式：application/json;charset=UTF-82. 公共请求参数： 字段必须类型说明serviceName是String服务名称accessKey是String商户账号secretKey是String商户秘钥timestamp是Long时间戳businessNo是String商户流水号3. 请求参数： 字段必须类型说明mobile是String手机号idNum是String根据证件类型传入对应证件号name是String姓名idt否Integer证件类型： 0：18位身份证1：军官证2：护照3：港澳证4：台胞证5：警官证6：⼠兵证7：澳门居民来往内地通行证8：香港居民来往内地通行证9：组织机构代码证10：营业执照号11：外国人居留证12: 15位身份证99：其它证件encryptType否String加密类型： MD5; SHA256; SM34. 请求示例{ "serviceName":"api_verify_mobile_rr", "accessKey":"xxx", "timestamp":1602296068483, "businessNo":"602296068483", "secretKey":"xxx", "mobile":"xxx", "name":"张三","idNum":"xxx"}5. 响应参数 字段级别必须类型说明status一级是String响应码message一级是String说明data一级是String结果value二级是String-1：未查得 Y：一致 N：不一致operator二级否Integer1：移动2：联通3：电信4：广电6. 响应成功示例{ "status":"0000", "message":"请求成功", "data":{ "value":"Y" }}7. 响应失败示例{ "status":"5000", "message":"数据源异常"}8. 响应码说明status说明0000请求成功3000无效的商户或已禁用3001商户余额不足3002IP受限3003商户没有该API访问权限4000查询参数异常4001时间戳无效4002商号入参流水号无效4004相同键请求过于频繁4005产品调用超限4010查询参数异常：身份证格式错误4011查询参数异常：姓名格式错误4012查询参数异常：不支持的手机号4013查询参数异常：银行卡格式错误5000数据源异常

1. Invocation Instructions:
Request Method: POST
Service Name: api_verify_mobile_rr
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 |
| idNum | Yes | String | Corresponding ID number entered based on ID type |
| name | Yes | String | Full name |
| idt | No | Integer | ID type: 0: 18-digit ID card, 1: Officer ID card, 2: Passport, 3: Hong Kong-Macau Exit-Entry Permit, 4: Taiwan Resident Travel Permit to Mainland China, 5: Police Officer ID Card, 6: Soldier ID Card, 7: Macau Resident Travel Permit to Mainland China, 8: Hong Kong Resident Travel Permit to Mainland China, 9: Organization Code Certificate, 10: Business License Number, 11: Foreigner's Residence Permit, 12: 15-digit ID card, 99: Other certificates |
| encryptType | No | String | Encryption type: MD5; SHA256; SM3 |

4. Request Example:
{"serviceName":"api_verify_mobile_rr", "accessKey":"xxx", "timestamp":1602296068483, "businessNo":"602296068483", "secretKey":"xxx", "mobile":"xxx", "name":"Zhang San", "idNum":"xxx"}

5. Response Parameters:
| Field Level | Required | Type | Description |
|-------------|----------|------|-------------|
| status | First-level | Yes | String | Response code |
| message | First-level | Yes | String | Description |
| data | First-level | Yes | String | Result |
| value | Second-level | No | String | -1: No record found, Y: Consistent, N: Inconsistent |
| operator | Second-level | No | Integer | 1: China Mobile, 2: China Unicom, 3: China Telecom, 4: China Broadcasting Network |

6. Successful Response Example:
{"status":"0000", "message":"Request succeeded", "data":{"value":"Y"}}

7. Failed Response Example:
{"status":"5000", "message":"Data source exception"}

8. Response Code Explanation:
| Status Code | Description |
|-------------|-------------|
| 0000 | Request succeeded |
| 3000 | Invalid merchant or 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 number |
| 4013 | Abnormal query parameters: Incorrect bank card format |
| 5000 | Data source exception |

搜集汇总

背景与挑战

背景概述

该数据集为联通三要素验证API服务，提供手机号、身份证号和姓名的核验功能，采用按次计费方式，每次调用参考定价为0.15元。