1.功能说明

1.1.用于校验身份信息 [姓名、身份证号] 与人脸是否一致；
1.2.广泛用于实名注册、登记等需要验证身份信息的场景如酒店、网吧、电商、金融贷款、刷脸门禁等；
1.3.接口发送调用地址：http(s)://api.guoyangyun.com/api/verify/idCardPortrait.htm
1.4.请求方式：以HTTP POST请求的方式（推荐使用post方式）；
1.5.汉字字符集：UTF-8，请注意参数的大小写。

2.输入参数

参数	名称	类型	必须	描述
公共参数	公共参数	—	是	详见《公共参数和配置》文档
name	姓名	String	是	中文请使用 utf-8编码，防止乱码导致验证不通过。
idCardNo	身份证号码	String	是	身份证号码
photo	人像图片	String	否	人像图片base64字符串。建议使用，能缩短耗时（可能需要URLEncoder.encode防止乱码）。photo、photoUrl二选一。
photoUrl	人像图片	String	否	人像图片url地址。（photo、photoUrl二选一）

照片字符串注意说明：

1）支持 jpg、jpeg、bmp、png 格式（建议jpg、png）
2）照片为生活照，宽和高大于15px，小于4000px，图片大小范围在16-500KB以内
3）照片像素不宜太低
4）保证五官清晰可见，传正脸照片不要旋转，不能有刘海，背光不能太强
5）照片请勿反光、污损、模糊或梯度变形
6）照片请勿强曝光、逆光。背光等
7）照片请勿出现人脸遮挡（头饰、头发等），勿带口罩、墨镜

3.调用示例

http(s)://api.guoyangyun.com/api/verify/idCardPortrait.htm?appkey=xxxxxxx&appsecret=xxxxxxx&name=xxxxx&idCardNo=xxxxxxxx&photo=xxxxxxx

4.Json返回

4.1.返回参数

参数	名称	类型	描述
code	返回码	String	提交返回结果。0：表示成功，其他：失败。（状态码详见：《公共错误代码定义》）
msg	信息描述	String	返回码对应的中文描述。
data	核验结果	List	核验结果返回详情
responseCode	校验结果	String	0：验证通过；其他：验证不通过
responseDesc	结果描述	String	核验结果描述
hackScore	相似度分数	String	人像比对相似度分数
traceNo	流水号	String	商户流水号

‘hackScore’相似度分值参考

[0，600）系统判断为不同人；
[600，700）不能确定是否为同一人；
[700，1000]系统判断为同一人；

4.2.调用成功样例

{
    "code":"0",
    "msg":"成功",
    "data": {
        "responseCode": "0",        //核验编码
        "responseDesc": "身份证号与姓名匹配，照片系统判断为同一人",  //比对结果描述
        "hackScore": "776.60",      //人像比对相似度分数
        "traceNo": "3b71a1773a7"    //商户流水号
    }
}

4.3.调用失败样例

{
    "code":"XXXX",
    "msg":"错误提示内容"
}

身份证人像核验接口