实名认证API接口是一种通过验证身份证号码和姓名的一致性,来判断身份信息是否真实有效的接口服务。在实时查询官方权威渠道的基础上,可以返回身份证的生日、性别、籍贯等详细信息。
本文将介绍如何使用实名认证API接口来验证身份证号码与姓名的一致性,并通过代码示例进行说明。
API接口介绍
接口名称:实名认证API接口 接口地址:https://www.wapi.cn/api/realname/verify 请求方式:POST 支持格式:JSON 参数类型:字符串 参数编码:UTF-8
接口参数说明
参数名 | 类型 | 说明 |
---|---|---|
name | String | 身份证持有人姓名 |
idCard | String | 身份证号码 |
返回结果说明
调用实名认证API接口后,将返回以下字段的信息:
字段名 | 类型 | 说明 |
---|---|---|
resultCode | String | 返回码 |
resultMsg | String | 返回消息 |
realName | String | 身份证姓名 |
idCard | String | 身份证号码 |
gender | String | 性别 |
birthday | String | 生日 |
nativePlace | String | 籍贯 |
请求示例
import requests
import json
url = "https://www.wapi.cn/api/realname/verify"
data = {
"name": "张三",
"idCard": "320123198001011234"
}
headers = {
"Content-Type": "application/json"
}
response = requests.post(url, data=json.dumps(data), headers=headers)
result = response.json()
print(result)
响应示例
{
"resultCode": "200",
"resultMsg": "成功",
"realName": "张三",
"idCard": "320123198001011234",
"gender": "男",
"birthday": "1980-01-01",
"nativePlace": "江苏省南京市"
}
错误码说明
错误码 | 说明 |
---|---|
200 | 成功 |
400 | 请求参数错误 |
401 | 账号未授权 |
402 | 账号已过期 |
403 | 账号余额不足 |
500 | 服务器内部错误 |
501 | 网关异常 |
502 | 接口权限不足 |
503 | 接口请求过于频繁 |
600 | 身份证姓名不一致 |
601 | 身份证号码不合法 |
602 | 身份证号码与姓名不匹配 |
603 | 身份证号码不存在 |
604 | 身份证号码已失效 |
以上是实名认证API接口的使用说明,通过调用该接口可以验证身份证号码与姓名的一致性,并返回详细的身份信息。请注意按照接口要求进行参数传递和错误处理,以确保接口调用的准确性和可靠性。