人证比对API接口调用文档解析

人证比对接口也叫人证合一接口，是一种特定的API接口服务，主要用于将提供的人脸图片和对应的身份证照片/姓名/身份证号码进行比对，以此验证其身份。这种接口的功能基于复杂的人脸识别技术，一般通过使用人工智能和深度学习算法来实现。

人证比对接口在许多需要实名身份验证的行业中都找到了用途。金融、保险、公安、网络安全、电子商务和许多其他行业都对这种技术有着广泛的需求，因为它能尽可能降低被虚假身份欺诈的风险。

【API文档】

请求地址：https://api.shumaidata.com/v4/face_id_card/compare

请求方式：POST

参数：

签名算法说明：

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

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

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

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

正确返回：
{
    "msg": "成功",
    "success": true,
    "code": 200,
    "data": {
        "order_no": "673106944390729728",
        "score": 0.86,
        "msg": "系统判断为同一人",
        "incorrect": 100,
        "sex": "男",
        "birthday": "19930123",
        "address": "江西省吉安地区遂川县"
    }
}
错误返回：
{
    "msg": "入参错误，身份证号[idcard]格式错误", 
    "success": false, 
    "code": 400, 
    "data": {}
}

返回字段说明：

incorrect字段详解：

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

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

104数据非法：

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

103，104区别：

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

104，107区别：

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

code错误码说明：