腾讯云人脸识别活体人证比对使用说明

人证比对(支持活体)
 
简要描述
 
用户提供身份证号码，姓名及自拍照，服务对提供的信息进行检测，判断身份证号码，姓名是否对应有效，自拍照是否和身份证照片一致。

建议上传图片分辨率固定为480*640，不超过1080P。
建议上传照片是头像（人脸部分），避免人脸部分过小，照片清晰，表情自然，光线均匀，避免强光、逆光和阴阳脸出现。
照片要求正面、俯仰、平面角度均不大于15度，左右角度不大于30度，面部轮廓清晰，双眼距离建议不小于90像素，表情自然。

请求参数说明
 
注：Content-Type为'application/json; charset=utf-8'
    {  "request_id":"abcdefg",    // [string] 用户http请求的唯一标识，由客户端生成
       "agreement_id":"AI",       // [string] 用户协议唯一标识，由客户端传入系统英文简称
       "person_id":"123456789012345678",  // [string] 身份证号码
       "person_name":"张三"， // [string] 用户姓名
    "bio":true，                     // [bool] 是否使用腾讯的活体检测功能（腾讯的活体检测更准确，true为使用、false为不使用）
       "device":{
                    "plat":"3",            // [string] 平台，其中客户端平台类型为(1->android, 2->ios, 3->pc, 4-> server)
                    "version":"10.3.3",       // [string] 版本号
                    "model":"MBP 2017"   // [string] 机型
                    }，
       "file":{
                 "type":"jpg",                    // [string] 文件类型
                 "data":"XXXX"                // [string] Base64编码后的图片内容
               }
    }
返回参数说明
 
注：Content-Type'application/json; charset=utf-8'
注：当错误码code不为0时，data部分数据返回为空字符串
    {  "code":0,                                    // [string] 接口状态码
       "msg":"",                                     // [string] 结果描述
       "request_id":"abcdefg",              // [string] 请求的唯一标识
       "data":{    
                "similarity":80.12,               // [string] 自拍照和标准底照相似度
                "ref_thres":"{"1e-3":76.5，"1e-4":90.6}"   // [string] 参考阈值(1e-3为千分之一误识率对应的阈值、1e-4为万分之一误识率对应的阈值)
       },
    "cost_time":345                           // [int] 接口处理时间( ms)
    }

错误码说明
 
0
接口调用成功（返回相似度用于验证生活照和公安照是否为同一人，超过推荐阈值即判断为同一人）
 
 
402**
人脸检测不通过
 
40201：没有人脸
 
403**
 
照片质量不通过
 
40301：图片太大 40302：照片模糊 40303：质量不通过 40304：图片解析错误
 
404**
 
活体识别失败（活体相似度低于默认阈值，判断为非活体）
 
40401：非活体
 
405**
 
身份证底图问题
 
40501：底图不存在 40502：底图解析错误
 
401**
 
双因素（姓名或身份证）不通过
 
40101：认证未通过 40102：姓名格式不正确,不能为空 40103：身份证号码有误 40105：无此身份证号