- API
- 身份证三要素核验
POST/facecheck
无参数
无参数
- 接口文档
- 请求示例
- 成功响应
- 失败响应
- 错误码
- 调用结果
接口信息
https://sfz3.market.alicloudapi.com/facecheck
POST
JSON
接口参数
无参数
无参数
字段名称 | 必填 | 字段详情 |
---|---|---|
xm string | Y | 个人真实姓名,不含空格 实例值: 李三 |
sfz string | Y | 身份证号码 实例值: 36020319********** |
img string | Y | BASE64人像图片,50KB以内;或http开头的图片网络地址,JPG/PNG格式。 实例值: /9j/4AAQSkZJR***BAAD/4gI*** |
商品介绍
产品亮点
产品说明
产品概述:
输入真实姓名、身份证号码和一张人脸照片,与 公安库身份证头像进行权威比对。并同时返回与身份证相关联的基本信息(出生日期、性别、可能的籍贯或出生地区等)。
【1】error参数情况:
0:身份证号与姓名匹配,照片核验成功。
1:身份证号与姓名匹配,照片核验失败。
2:身份证号与姓名匹配,无法确定是否为同一人。
3:身份证号与姓名匹配,官方未采集用户照片。
4:身份证号与姓名匹配,照片检测失败。
5:无此身份证号码。
6:身份证号与姓名不匹配。
7:参数缺失。
8:查询过于频繁,请稍后再试。
9:其他失败情况。
【2】关于照片要求:像素不宜太低;字节不宜超过50KB;请勿反光、污损、模糊或梯度变形;请勿强曝光、逆光、背光等;请勿出现人脸遮挡(头饰、头发等),勿带口罩、墨镜。
【3】为避免滥用服务资源,接口对查询频率和24小时内相同姓名或卡号的核验次数进行了限制。如遇相关错误提示(如错误代码8和9),请适当调整查询策略或联系服务商了解详情。
Aliyun零代码调用平台URL: https://www.zpzzq.com/ali/cmapi00066828.do
使用说明: Aliyun零代码调用平台旨在为非技术背景人员如企业老板、采购经理、产品经理等带来极大便利,使你们能快速、直观地了解API的功能、性能等指标,掌握其核心功能,无需深入技术细节。促进产品团队与技术团队之间的沟通与协作,使双方能更高效地交流想法与需求,共同推动产品快速迭代与优化。降低部门沟通成本,提升企业整体运营效率与创新能力。建议收藏Aliyun零代码调用平台,我们不会保存您AppCode的重要凭证,请注意您浏览器Cookie的安全性,方可放心使用。
请求参数(Query):
字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
---|---|---|---|---|---|
人像图片 | img | 是 | String(MAX) | /9j/4AAQSkZJR***BAAD/4gI*** | BASE64人像图片,50KB以内 |
身份证号码 | sfz | 是 | String(20) | 36020319********** | 身份证号码 |
真实姓名 | xm | 是 | String(14) | 李三 | 个人真实姓名,不含空格 |
成功响应(Json):
{ "ok": 1, "msg": "身份证号与姓名匹配,照片核验成功。", "xm": "李**", "sfz": "3502******1X", "match": true, "error": 0, "birthday": "2011-02-01", "sex": "男", "address": "福建省厦门市思明区" } |
成功响应报文解释(Json):
字段名 | 类型 | 示例值 | 描述 |
---|---|---|---|
ok | number | 1 | 成功标识:1成功,0失败 |
msg | string | 身份证号与姓名匹配,照片核验成功。 | 报文成败描述 |
xm | string | 李** | 真实姓名 |
sfz | string | 3502******1X | 身份证号码 |
match | boolean | true | 校验状态:true一致;false不一致 |
error | number | 0 | 成功标识:0成功,其他数值请查阅开发文档的注意事项 |
birthday | string | 2011-02-01 | 解析的生日信息 |
sex | string | 男 | 性别 |
address | string | 福建省厦门市思明区 | 身份证所属行政区域 |
失败响应(Json):
{ "ok": 1, "msg": "身份证号与姓名匹配,照片核验失败。", "xm": "李**", "sfz": "3502******1X", "match": false, "error": 1, "birthday": "2011-02-01", "sex": "男", "address": "福建省厦门市思明区" } |
失败响应报文解释(Json):
字段名 | 类型 | 示例值 | 描述 |
---|---|---|---|
ok | number | 1 | 成功标识:1查询成功,0失败(不计费) |
msg | string | 身份证号与姓名匹配,照片核验失败。 | 报文成败描述 |
常见的失败类型:
ok | msg | 解决方式 |
---|---|---|
0 | 未传入真实姓名xm | 请传入xm真实姓名。 |
0 | 未传入身份证号码sfz | 请传入sfz身份证号码。 |
0 | 未传入人像图片img | 请上传人像图片,支持网址或base64。 |
0 | 传入真实姓名xm字符串长度超限 | xm参数长度不得超过50个字符。 |
0 | 传入身份证号码sfz字符串长度超限 | sfz参数长度不得超过18个字符。 |
0 | 传入人像图片img字符串长度超限 | img参数长度不得超过100KB. |
0 | 错误的身份证号码 | sfz参数传入不符合身份证标准,请检查。 |
1 | 无此身份证号码 | 请检查传入的身份证号码后再试。 |
1 | 身份证号与姓名不匹配 | 核验结果不一致。 |
1 | HTTP人像图片错误:下载失败 | 检查传入的img参数值。 |
1 | HTTP人像图片错误:不支持的文件格式 | 检查传入的img格式。 |
1 | BASE64人像图片错误:无法处理图片信息 | 检查传入的img信息。 |
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元60次【不限加测】 | 版本基础价格 | 10元 |
160元1000次 | 版本基础价格 | 160元 |
3000元2万次 | 版本基础价格 | 3000元 |
13000元10万次【促销直降1000】 | 版本基础价格 | 13000元 |
7万元50万次 | 版本基础价格 | 70000元 |
26万元200万次【2年期】 | 版本基础价格 | 260000元 |
60万元500万次【2年期】 | 版本基础价格 | 600000元 |
使用指南
立即下载服务商
拇指云(厦门)软件有限公司
- 数据与API
- 专业服务
用户评论 (6)
正式使用
好评
数据准确
试用没问题,好评
可以使用,谢谢推荐
稳定才是王道