实名认证API接入指南：从银行卡二三四要素到身份证二要素核验一站式解决方案

在身份验证和信息核验场景中，确保用户身份的真实性和合法性至关重要。**万维易源提供的“银行卡身份证实名验证”API为企业和开发者提供了一个高效、安全的工具，用于验证身份证信息的真实性。**本文将详细介绍如何使用该API，以及其核心功能和调用方法。

一、API概述

1. 接入点说明

以身份证二要素为例：该API通过输入**姓名和身份证号，校验这两个要素是否一致，并返回性别、生日和籍贯等额外信息。**广泛应用于信贷、安防、银行、保险等行业及各种身份核查场景。API直连官方数据源，提供实时核验，毫秒级响应，确保数据的准确性和时效性。

2. 注意事项

• 正常调用：当请求参数符合“固定同一个参数，其余参数不同”，例如“同一个身份证，不同姓名”，并且检验次数为<=10次，认为正常调用。
• 恶意调用：当>10次以上，我们认为是恶意调用，此时返回“24小时内相同姓名或卡号核验次数超限”，不扣费。
• 错误参数：当请求参数存在明显错误（比如身份证号位数错误），二十四小时内同一个错误参数调用超过10次，将进行扣费。

3. 接口地址

https://route.showapi.com/1072-1?appKey={your_appKey}

请将 {your_appKey} 替换为你在万维易源平台申请的个人 appKey。

二、请求参数

以下是提交身份证实名验证任务所需的请求参数：

参数名称	类型	示例值	必须	描述
idcard	String	（身份证号）	是	身份证号，测试时注意不要填错，填错一样扣减使用次数。
name	String	（姓名）	是	姓名，测试时注意不要填错，填错一样扣减使用次数。

三、返回参数

以下是接口返回的参数及其描述：

参数名称	类型	示例值	描述
birthday	String	1991-11-04	生日。
ret_code	Number	0	返回码，0 表示成功，计费，其余为失败，不计费。
sex	String	F	性别：M 为男性，F 为女性。
order	String	145801957588529905	相关流水号。
county	String	清徐县	区县。
address	String	山西太原市清徐县	详细地址。
province	String	山西省	省。
code	Number	0	验证标示： 0：匹配 1：不匹配 2：无此身份证号码 3：身份证号与姓名匹配，照片比对失败 4：参数不能为空 5：四要素匹配成功，照片比对失败 6：四要素匹配失败，照片比对成功 7：四要素匹配成功，照片异常 12：身份证号码不合法 13：照片质量异常 14：姓名异常 15：暂不支持该地域校验 100：渠道异常，请稍后再试 101：验证信息重复输入，避免恶意验证请间隔60秒以上再次核验 102：维护中 103：24小时内相同姓名或卡号核验次数超限 104：decrypt参数异常 202：姓名加密信息有误，请检查 203：身份证加密信息有误，请检查 205：开始时间加密信息有误，请检查 206：结束时间加密信息有误，请检查 207：人像照片加密信息有误，请检查
msg	String	匹配	说明。
city	String	太原市	城市。

四、调用示例

以下是一个使用 curl 命令调用该接口的示例：

curl 'https://route.showapi.com/1072-1?appKey=your_appKey' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'name=' \
  -d 'idcard='

请将 your_appKey 替换为你在万维易源平台申请的 appKey。

五、返回示例

以下是接口返回的JSON示例：

{
    "showapi_res_error": "",
    "showapi_res_code": 0,
    "showapi_res_id": "60d2da870de3769d4d2df7b4",
    "showapi_res_body": {
        "birthday": "1991-11-04",
        "ret_code": 0,
        "sex": "F",
        "order": "145801957588529905",
        "county": "清徐县",
        "address": "山西太原市清徐县",
        "province": "山西省",
        "code": 0,
        "msg": "匹配",
        "city": "太原市"
    }
}

六、获取 appKey

要获取 appKey，请访问万维易源的控制台页面：
查看 appKey

七、总结

万维易源的“银行卡身份证实名验证”API为企业和开发者提供了一个高效、安全的工具，用于验证身份证信息的真实性。通过简单的接口调用，可以快速获取身份证的详细信息和验证结果。希望本文能帮助你更好地了解和使用该API。如果你有任何问题或需要进一步的帮助，请随时访问万维易源的官方文档或联系技术支持。