一、接口名称：

人证比对接口

二、接口介绍：

人证合一接口可以输入姓名、身份证号码和头像照片，与公安库身份证头像进行权威比对，返回分值作为判断依据，与活体检测接口搭配使用效果更佳，广泛用于实名注册、登记等需要验证身份信息的场景。

三、API接口文档

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

1、请求地址

https://api.shumaidata.com/v4/face_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": "673106944390729728",

       "score": 0.86,

       "msg": "系统判断为同一人",

       "incorrect": 100,

       "sex": "男",

       "birthday": "19930123",

       "address": "江西省吉安地区遂川县"

   }

}

4、错误返回：

{

   "msg": "入参错误，身份证号[idcard]格式错误",

   "success": false,

   "code": 400,

   "data": {}

}

5、返回字段说明：

6、incorrect字段详解

103 身份核验成功，数据非法

公安已经进行了身份核验（姓名身份证号码一致），公安返回的错误:除库中无照片（109），特征提取失败（110），检测到多于一张人脸(111)，人脸识别系统异常(106)，图片不合法(112)以外的情况。

104 数据非法

公安未进行身份核验前图片校验，公安返回的错误:除照片质量不合格(107)，上传图片文件过大(108)，人像比对服务异常(113)以外的情况。

103，104区别

103证件号码一致，照片比对时报错；104未进行证件号校验，数据检验报错。

104，107区别

107检测到的公安错误；104未检测到的公安错误。

7、code错误码说明

》》》》》延伸接口推荐：活体检测接口