一、接口名称：

人脸比对接口

二、接口介绍：

人脸比对API指的是通过传入两张人脸照片，比对两张照片是否为同一人（一般为当前上传照和预留照片），常用于考勤打卡机、门禁等使用场景，用预留的照片跟当前照片做比较。

三、API接口文档

图片要求：格式为jpg或png，宽和高大于15px, 小于4000px，图片大小不能超过500kb，保证五官清晰可见，尽量传正脸照片不要旋转，不能有刘海，背光不能太强

1、请求地址

https://api.shumaidata.com/v2/face_compare/check

请求方式：POST

参数

注意：file、image、url三选一

2、签名算法说明：

商户分配的appid、当前时间毫秒数timestamp、商户分配的app_security、 三者通过&符号拼接成字符串进行md5加密得到。

如：appid=xyzxyzxyz，timestamp=1555378976238，app_security=efcefcefcefcefc;

拼接后的字符串：str=xyzxyzxyz&1555378976238&efcefcefcefcefc;

加密后得到sign = md5(str) = 4e7e1974b79f3656aeaf03f1158f5d5d;

3、正确返回：

{

   "msg": "成功",

   "success": true,

   "code": 200,

   "data": {

       "order_no": "608596343467937792",

       "score": 0.9891853928565979

   }

}

4、错误返回：

{

   "msg": "入参错误",

   "success": false,

   "code": 400,

   "data": {}

}

5、返回字段说明：

注意：当图片中存在多个人脸时，系统会选出其中最大的人脸进行比对

6、比较结果阈值和错误率对照

7、code错误码说明

》》》》》延伸接口推荐：认证比对接口