一、接口名称：

手持身份证验证接口

二、接口介绍：

手持身份证人脸比对接口指的是通过传入手持身份证的人脸照片，将照片中的人脸和所持身份证上的头像比对是否为同一人，主要用于验证是否为本人的场景，如网站注册、直播、购物、贷款等。

三、API接口文档

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

1、请求地址

https://api.shumaidata.com/v2/handhold/id_card/compare

请求方式：POST

参数

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": "613030796676173824",

       "score": 0.74336225

   }

}

4、错误返回：

{

   "msg": "入参错误",

   "success": false,

   "code": 400,

   "data": { }

}

5、返回字段说明：

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

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

7、code错误码说明

》》》》》延伸接口推荐：人脸比对接口、认证比对接口、活体检测接口