三要素详版-移动

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. 请求示例{ "serviceName":"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:
- serviceName (Required, String): Service Name
- accessKey (Required, String): Merchant Account
- secretKey (Required, String): Merchant Secret Key
- timestamp (Required, Long): Timestamp
- businessNo (Required, String): Merchant Serial Number
3. Request Parameters:
- mobile (Required, String): Phone Number
- idNum (Required, String): Corresponding ID number based on ID type
- name (Required, String): Full Name
- idt (Optional, Integer): ID Type: 0: 18-digit ID Card, 1: Officer ID Card, 2: Passport, 3: Hong Kong-Macao Travel Permit, 4: Taiwan Compatriot Travel Permit, 5: Police Officer ID Card, 6: Soldier ID Card, 7: Macao Resident Mainland Travel Permit, 8: Hong Kong Resident Mainland Travel Permit, 9: Organization Code Certificate, 10: Business License Number, 11: Foreigner Residence Permit, 12: 15-digit ID Card, 99: Other ID Documents
- encryptType (Optional, String): Encryption Type: MD5; SHA256; SM3
4. Request Example:
{"serviceName":"api_verify_mobile_detail_rr","accessKey":"xxx","timestamp":1602296068483,"businessNo":"602296068483","secretKey":"xxx","mobile":"xxx","name":"xxx","idNum":"xxx"}
5. Response Parameters:
- status (First-level, Required, String): Response Code
- message (First-level, Required, String): Description
- data (First-level, Required, String): Result
- value (Second-level, Optional, String): -1: No matching records found, Y: Matched, 2: Name mismatch, 3: ID number mismatch, 4: General mismatch
- operator (Second-level, Optional, Integer): 1: China Mobile, 2: China Unicom, 3: China Telecom, 4: China Broadcasting Network
6. Successful Response Example:
{"status":"0000","message":"Request Successful","data":{"value":"Y"}}
7. Failed Response Example:
{"status":"5000","message":"Data Source Exception"}
8. Response Code Explanations:
- 0000: Request Successful
- 3000: Invalid merchant or disabled account
- 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
- 4004: Duplicate requests sent too frequently
- 4005: Product call limit exceeded
- 4010: Abnormal query parameters: Invalid ID card format
- 4011: Abnormal query parameters: Invalid name format
- 4012: Abnormal query parameters: Unsupported phone number
- 4013: Abnormal query parameters: Invalid bank card format
- 5000: Data source exception

搜集汇总

背景与挑战

背景概述

该数据集为移动端三要素验证API服务，提供手机号、身份证和姓名的核验功能，采用POST请求返回JSON格式数据，每次调用参考定价0.36元。服务包含详细的请求响应参数定义及错误码体系，由北京宝华恩利科技有限公司提供。