- API
- 身份证二要素核验
GET/idcard
无参数
无参数
- 接口文档
- 请求示例
- 成功响应
- 失败响应
- 错误码
- 调用结果
接口信息
https://sfz2.market.alicloudapi.com/idcard
GET
JSON
接口参数
无参数
字段名称 | 必填 | 字段详情 |
---|---|---|
xm string | Y | 个人真实姓名,不含空格 实例值: 李三 |
sfz string | Y | 身份证号码 实例值: 36020319********** |
无参数
商品介绍
产品亮点
产品说明
产品概述:
验证身份证号码与真实姓名的官方实名认证结果,即是否一致性,并同时返回与身份证相关联的基本信息(出生日期、性别、可能的籍贯或出生地区等)。
本软件已取得软件著作权登记号: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。
产品参数
交付方式 | API |
开票主体 | 拇指云(厦门)软件有限公司 |
所属类目 | 身份核验与金融银行 |
上架日期 | 2024-07-23 |
售后支持范围
产品资质
商品价格(此处价格仅供参考,实际价格以选配后的价格为准)
版本名称 | 计费项 | 新购 |
10元300次【不限加测】 | 版本基础价格 | 10元 |
360元1万次 | 版本基础价格 | 360元 |
1700元5万次 | 版本基础价格 | 1700元 |
6000元20万次【促销】 | 版本基础价格 | 6000元 |
3万元110万次【2年】 | 版本基础价格 | 30000元 |
8万元300万次【3年】 | 版本基础价格 | 80000元 |
10万500万次【3年】 | 版本基础价格 | 100000元 |
使用指南
立即下载服务商
拇指云(厦门)软件有限公司
- 数据与API
- 专业服务
用户评论 (5)
正式使用
谢谢优惠
速度确实快
试用没问题,好评
响应还不错,支持下拇指云,给力