facePersonVerify

解释：公安验证，基于姓名和身份证号，调取公民身份证小图（源自公安系统），将当前获取的人脸图片，与此证件小图进行对比，得出比对分数。

最低支持版本 3.20.11 。

方法参数：ObjectObject 参数说明：

参数名参数类型是否必填说明
imagestring是图片信息(总数据大小应小于 10M)，图片上传方式根据 image_type 来判断。
image_typestring是图片类型· BASE64:图片的 base64 值，base64 编码后的图片数据，编码后的图片大小不超过 2M；· URL:图片的 URL 地址( 可能由于网络等原因导致下载图片时间过长)；· FACE_TOKEN: 人脸图片的唯一标识，调用人脸检测接口时，会为每个人脸图片赋予一个唯一的 FACE_TOKEN，同一张图片多次检测得到的 FACE_TOKEN 是同一个。
id_card_numberstring是身份证号码
namestring是姓名
quality_controlstring否图片质量控制。· NONE: 不进行控制；· LOW:较低的质量要求；· NORMAL: 一般的质量要求；· HIGH: 较高的质量要求；默认 NONE，若图片质量不满足要求，则返回结果中会提示质量检测失败。
liveness_controlstring否活体检测控制。· NONE: 不进行控制；· LOW:较低的活体要求(高通过率 低攻击拒绝率)；· NORMAL: 一般的活体要求(平衡的攻击拒绝率, 通过率)；· HIGH: 较高的活体要求(高攻击拒绝率 低通过率)。默认 NONE，若活体检测结果不满足要求，则返回结果中会提示活体检测失败。
successFunction否接口调用成功后的回调函数
failFunction否接口调用失败的回调函数
completeFunction否接口调用结束的回调函数（调用成功、失败都会执行）

返回值说明

参数名参数类型说明
log_idstring日志 ID
scorenumber与公安小图相似度可能性，用于验证生活照与公安小图是否为同一人，有正常分数时为 [0~100]，推荐阈值 80，超过即判断为同一人。

示例代码

  1. swan.ai.facePersonVerify({
        image: 'https://www.downloadImage.com/xxxx.jpg',
        image_type: 'URL',
        quality_control: 'NONE',
        liveness_control: 'NONE',
        id_card_number: '',
        name: '',
        success(res) {
            console.log('success', res);
        }
    });

返回示例

  1. {
      "score": 44.3,
    }