POSTidcard-face-validate
人脸身份证比对
提供姓名、身份证号及人脸照片三要素一致性核验服务,通过比对照片与身份信息,返回是否一致及相似度得分,辅助判断用户身份真实性。
30 匠币/次
在线调试
无需写代码,浏览器中直接发起真实请求
接入文档
接口能力
本接口提供人脸与身份证信息的一致性核验服务。通过传入用户的姓名、身份证号码以及现场采集的人脸照片,系统将比对这三要素是否匹配,并返回比对结果(一致或不一致)、相似度得分及比对阈值。该接口可作为实名认证流程中的重要辅助手段。
请求与返回
- 请求参数:需提供真实姓名(
name)、18位身份证号码(idCardNo)以及人脸照片的有效网络地址(facePhotoUrl)。 - 返回结果:返回
result字段说明比对结论(如“一致”),similarity字段表示人脸相似度得分(0-1之间),threshold字段为建议的判断阈值。当相似度大于等于阈值时,通常可认为是一致的。
使用场景
- 金融开户与交易:在银行、证券、保险等金融业务中,辅助验证用户身份,防范欺诈风险。
- 共享经济与出行:网约车、共享汽车、酒店入住等场景下的司机或用户实名登记。
- 安防与门禁管理:重要场所的访客登记、员工入职身份核实等。
使用说明与限制
- 请确保传入的人脸照片清晰、无遮挡、光线良好,以提高比对准确率。
- 本接口仅提供信息比对服务,比对结果仅供辅助参考,不构成最终的法律或业务结论。
- 提交照片及身份信息时,请务必遵守相关隐私保护法规,在获取用户明确授权后使用,并落实最小化数据采集原则,避免泄露敏感个人信息。
接入示例代码
提供 Shell、Python、Go、Java、PHP 等常见接入示例,便于直接接到现有项目里。
请求示例
{
"name": "张三",
"idCardNo": "110105199003078887",
"facePhotoUrl": "https://example.com/face.jpg"
}响应示例
{
"code": "SUCCESS",
"message": "success",
"data": {
"result": "一致",
"similarity": 0.92,
"threshold": 0.7
}
}请求字段
以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 示例值 |
|---|---|---|
| name | string | 张三 |
| idCardNo | string | 110105199003078887 |
| facePhotoUrl | string | https://example.com/face.jpg |
响应字段
以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 示例值 |
|---|---|---|
| code | string | SUCCESS |
| message | string | success |
| data | object | {...} |
| data.result | string | 一致 |
| data.similarity | number | 0.92 |
| data.threshold | number | 0.7 |