【拇指云】全国身份证二要素实名认证API接口：姓名+身份证号（支持免开发调用）

　　产品概述：
　　验证身份证号码与真实姓名的官方实名认证结果，即是否一致性，并同时返回与身份证相关联的基本信息（出生日期、性别、可能的籍贯或出生地区等）。
　　本软件已取得软件著作权登记号：2023SR1488853《基于云市场API交付的身份证实名校验软件》，提供高效、准确的身份证实名校验服务，助力企业高效合规地进行用户身份验证。同时推出了《身份证实名校验API接口之云市场零代码调用平台》（软件著作权登记号：2023SR1486360），进一步降低了开发门槛，允许用户无需编写代码即可使用实名校验功能（具体与拇指云客服交流），极大地提升了开发效率与灵活性，满足了从专业开发者到普通用户的多样化需求。

　　Aliyun零代码调用平台URL： https://www.zpzzq.com/ali/cmapi00066827.do

　　使用说明： Aliyun零代码调用平台旨在为非技术背景人员如企业老板、采购经理、产品经理等带来极大便利，使你们能快速、直观地了解API的功能、性能等指标，掌握其核心功能，无需深入技术细节。促进产品团队与技术团队之间的沟通与协作，使双方能更高效地交流想法与需求，共同推动产品快速迭代与优化。降低部门沟通成本，提升企业整体运营效率与创新能力。建议收藏Aliyun零代码调用平台，我们不会保存您AppCode的重要凭证，请注意您浏览器Cookie的安全性，方可放心使用。

　　请求参数（Query）：

字段名	变量名	必填	类型	示例值	描述
身份证号码	sfz	是	String(32)	36020319**********	身份证号码
真实姓名	xm	是	String(14)	李三	个人真实姓名，不含空格

 

　　成功响应（Json）：

 

{      "ok": 1,      "msg": "实名信息正确",      "xm": "庆**",      "sfz": "3505******12",      "match": true,      "birthday": "19****16",      "sex": "男",      "address": "福建省泉州市**县"     }

 

　　成功响应报文解释（Json）：

 

字段名	类型	示例值	描述
ok	number	1	成功标识：1成功，0失败
msg	string	实名信息正确	报文成败描述
birthday	string	19****16	解析的生日信息
address	string	福建省泉州市**县	身份证所属行政区域
xm	string	庆**	真实姓名
sfz	string	3505******12	身份证号码
sex	string	男	性别
match	boolean	true	校验状态：true一致；false不一致

 

 

　　失败响应（Json）：

{      "ok": 0,      "msg": "身份证号码有误"     }

 

　　失败响应报文解释（Json）：

 

字段名	类型	示例值	描述
ok	number	0	成功标识：1查询成功，0失败（不计费）
msg	string	身份证号码有误	报文成败描述

　　常见的失败类型：

ok	msg	解决方式
0	未传入真实姓名xm	请传入xm真实姓名。
0	未传入身份证号码sfz	请传入sfz身份证号码。
0	传入真实姓名xm字符串长度超限	xm参数长度不得超过50个字符。
0	传入身份证号码sfz字符串长度超限	sfz参数长度不得超过18个字符。
0	姓名有误	xm参数传入不符合真实姓名，请检查。
0	身份证号码有误	sfz参数传入不符合身份证标准，请检查。
1	实名校验失败:身份证与姓名不匹配	核验结果不一致。
1	实名校验失败:查无记录	无记录，无法核验。
0	未传入开发者账号appid	对接拇指云自研平台才出现：请传入appid开发者账号。
0	传入开发者账号appid字符串长度超限	对接拇指云自研平台才出现：appid字符串长度不得超过32个字符。
0	未传入查询时间sendtime	对接拇指云自研平台才出现：请传入sendtime时间戳。
0	传入查询时间sendtime字符串长度超限	对接拇指云自研平台才出现：请检查传入sendtime时间戳的长度。
0	时间戳超时，请重新请求	对接拇指云自研平台才出现：传入sendtime时间戳误差不得超过5分钟。
0	未传入签名sign	对接拇指云自研平台才出现：请传入sign签名结果。
0	传入签名sign字符串长度超限	对接拇指云自研平台才出现：请检查传入sign签名的长度。
0	签名校验失败	对接拇指云自研平台才出现：请参照平台签名校验流程进行对比调试。
0	存在*字符，视为调试数据。止于当前结果。	对接拇指云自研平台才出现：传入的参数值包含*字符，都将视为测试数据，仅用于调试。
0	非法来源	禁止将API用于任何形式的攻击行为，请注意。
0	appid:XXXXXXX接口已停用	对接拇指云自研平台才出现：XXXXXXX开发者已被拇指云停止调用。

　　1、次数扣减规则

　　阿里云的次数扣减规则基于http响应状态码执行，只有当http响应状态码为200~300范围内时，才会扣减调用次数。对于非200系列的响应状态码，您需要自行处理响应，并获取响应中的JSON数据。http响应状态码对照表请参考https://help.aliyun.com/document_detail/43906.html
　　若调用成功，返回的JSON数据包中的“OK”字段值为1，且http响应状态码为200。在这种情况下，阿里云会进行计费。
　　若调用失败，返回的JSON数据包中的“OK”字段值可能为0或其他非1的值，失败的具体原因会在“msg”字段中描述。此时http响应状态码被设置为666，阿里云不会对此次调用进行计费。
　　当调用次数用尽时，返回http响应状态码403，并附带消息“Quota Exhausted”。此时您只需续费即可恢复正常使用。

　　2、请求参数合法和准确性

　　① 开发者在使用API进行数据处理时，保证数据的准确性和完整性，不得进行任何篡改或伪造数据的行为。
　　② 在使用API的过程中，开发者应采取必要的安全措施，确保数据不被未授权访问或泄露，保障数据安全。
　　③ 开发者使用该接口时，确保遵守所有相关法律法规，不得将其用于任何非法或侵犯他人隐私的行为。
　　④ 开发者应定期对API的使用情况进行审计，确保使用行为始终符合规定要求，并进行必要的调整和改进。
　　⑤ 开发者不得将API用于任何形式的攻击行为，包括但不限于网络攻击、数据洪峰等。
　　⑥ 本接口适用于市场调研、商业合作、风险评估等多种场景，开发者可以根据实际需求合理使用。
　　⑦ 如发现API存在安全漏洞或潜在风险，开发者应立即停止使用并通知我们进行处理。
　　⑧ 开发者在使用API时，应尊重并保护我们的知识产权，不进行任何侵犯版权、商标等合法权益的行为。

　　1、消息提醒设置

　　您可以通过【消息中心·基本接收管理】https://notifications.console.aliyun.com/#/subscribeMsg进行相应设置，以避免因次数耗尽而影响业务运行。

　　2、发票开具与申请

　　您可以通过【费用与成本·发票管理】https://usercenter2.aliyun.com/invoice/create-by-detail/aliyun进行发票申请。我们将为您提供数电发票，支持普通电子发票和电子专票的开具。

　　3、开发密钥查看

　　您可以通过【已购买的服务】https://market.console.aliyun.com/imageconsole/index.htm 中对应我们的产品，查看AppKey/AppSecret或appCode。该界面您还可以查阅调用量、到期时间等概要信息。

　　4、服务热线

　　 有任何疑问或建议，欢迎拨打服务热线：4009030002 转16250，我们的服务时间为：工作日09:00-18:00。