三要素详版-联通

1. 调用说明： 请求方式：post服务名称：api_verify_mobile_detail_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. 请求示例erviceName":"api_verify_mobile_detail_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：一致2：姓名不一致3：身份证不一致4：不一致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. Call Instructions: Request Method: POST; Service Name: api_verify_mobile_detail_rr; Parameter Format: application/json;charset=UTF-8 2. Common 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 certificate number entered based on certificate type | | name | Yes | String | Full name | | idt | No | Integer | Certificate type: 0: 18-digit ID card; 1: Officer Certificate; 2: Passport; 3: Hong Kong-Macao Exit-Entry Permit; 4: Taiwan Compatriots Travel Permit; 5: Police Officer Certificate; 6: Soldier Certificate; 7: Mainland Travel Permit for Macao Residents; 8: Mainland Travel Permit for Hong Kong Residents; 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 types: MD5; SHA256; SM3 4. Request Example: json { "serviceName":"api_verify_mobile_detail_rr", "accessKey":"xxx", "timestamp":1602296068483, "businessNo":"602296068483", "secretKey":"xxx", "mobile":"xxx", "name":"张三", "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 | - | String | -1: No match found; Y: Matched; 2: Name mismatch; 3: ID card number mismatch; 4: Overall mismatch | | operator | Second-level | No | Integer | 1: China Mobile; 2: China Unicom; 3: China Telecom; 4: China Broadcast Network 6. Successful Response Example: json { "status":"0000", "message":"Request successful", "data":{ "value":"Y" } } 7. Failed Response Example: json { "status":"5000", "message":"Data source exception" } 8. Response Code Explanations: | 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 | Query parameter exception | | 4001 | Invalid timestamp | | 4002 | Invalid merchant serial number in request parameters | | 4004 | Too frequent duplicate requests | | 4005 | Product call quota exceeded | | 4010 | Query parameter exception: Incorrect ID card format | | 4011 | Query parameter exception: Incorrect name format | | 4012 | Query parameter exception: Unsupported mobile phone number | | 4013 | Query parameter exception: Incorrect bank card format | | 5000 | Data source exception

搜集汇总

背景与挑战

背景概述

该数据集为联通三要素验证API服务，提供手机号、身份证和姓名的核验功能，采用POST请求方式，按0.15元/次的标准服务计费。