/v2/identity/portrait_verification_ys

• 1.接口描述
• 2.请求参数
• 3.返回参数
• 4.错误码

1.接口描述

（ys）该接口在身份核验的基础上，结合用户的活体检测动作，基于模型算法的能力，优先进行图片质量检测，判断用户图片是否清晰，是否过度曝光等；再对照片进行人像定位，特征提取；并最终判断是否为用户本人。
(注：此接口只提供比对相似度分数，不提供比对照片）

• 普通人脸图片要求
  1. 格式为 JPG（JPEG），BMP，PNG，GIF，TIFF
  2. 宽和高大于 8px，小于等于4000px
  3. 小于等于 2 MB，建议100KB以内
  4. 人脸双眼间距不小于30像素，建议90像素以上
  5. 图像中人脸图像较清晰，不因镜头散焦或运动而模糊
  6. 眼睛的瞳孔清晰可见,镜面无反光，禁止戴墨镜，且眼镜框不得遮挡眼睛，不要带宽框眼镜
  7. 人脸光线均匀且无阴影,亮度在200-800Lux，面部无明显反光、逆光、侧光
  8. 要求头发及饰物不能遮挡人脸，禁止戴口罩，帽子
  9. 表情自然、放松、无夸张动作,脸部区域完整、轮廓清晰、人脸比例不失真
  10. 照片中只允许有1张人脸，且背景简单，无复杂场景
  11. 人脸姿态要求，平面旋转（roll）±15°，俯仰变化（pitch）±10°，姿态偏转（yaw）±15°

• 支持自动识别人脸方向
  1. 上传的图片中包含有 exif 方向信息，先按此信息旋转、翻转后再做识别人脸方向并调整。
  2. 如果照片方向混乱且 exif 方向信息不存在或不正确，自动识别人脸方向并调整

请求方式：

POST

请求URL：

https://cloudapi.linkface.cn/v2/identity/portrait_verification_ys

2.请求参数

参数 selfie_file,selfie_url,selfie_image_id与selfie_image_base64必四选一，如同时传入多个参数，本API使用顺序为selfie_image_id优先，其次selfie_file、selfie_image_base64、selfie_url。

若将 URL 放入 Query String 中则需要对特殊字符进行转义，所有中文和特殊字符必需以UTF-8编码转义。 目前支持 http/https 等协议的网络地址。下载限时 5s，超时后仍未下载完成则属于失败。 参数 selfie_file 需把图片文件的内容以 multipart/form-data 的形式放到 POST 消息体中。 打开自动旋转功能会增加运算时间,请酌情考虑是否开通此功能

所有中文和特殊字符必需以UTF-8编码转义。

签名sign说明：

我们会为每位公有云用户分配一个账户API ID和对应秘钥API SECRET。为了保证安全性，用户的每次接口调用都需要上传一个签名（基于API ID和API SECRET获取）。

Java示例代码：

SHA256Util.getSHA256Str(LF_APP_ID + LF_APP_SECRET + timeStamp)
/**
     * 利用java原生的摘要实现SHA256加密
     *
     * @param str 加密后的报文
     */
    public static String getSHA256Str(String str) {
        MessageDigest messageDigest;
        String encodeStr = "";
        try {
            messageDigest = MessageDigest.getInstance("SHA-256");
            messageDigest.update(str.getBytes("UTF-8"));
            encodeStr = byte2Hex(messageDigest.digest());
        } catch (NoSuchAlgorithmException e) {
            e.printStackTrace();
        } catch (UnsupportedEncodingException e) {
            e.printStackTrace();
        }
        return encodeStr;
    }
    /**
     * 将byte转为16进制
     */
    private static String byte2Hex(byte[] bytes) {
        StringBuffer stringBuffer = new StringBuffer();
        String temp = null;
        for (int i = 0; i < bytes.length; i++) {
            temp = Integer.toHexString(bytes[i] & 0xFF);
            if (temp.length() == 1) {
                //1得到一位的进行补0操作
                stringBuffer.append("0");
            }
            stringBuffer.append(temp);
        }
        return stringBuffer.toString();
    }

3.返回参数

data 的结构如下：

收费标准： code为0000且check_result为1时，charge为1，收费； code不为0000，或者code为0000且check_result为2时，charge为2，不收费。

成功返回示例：

{
    "code": "0000",
    "msg": "调用成功",
    "charge": 1,
    "data": {
        "photo_result": 1,
        "check_result": 1,
        "selfie_image_id": "f950dc6b8116459d99969bcaf9d7a437",
        "certificate_score": 9.000000000000002,
        "id_name_result": 1
    },
    "request_id": "TIDabc8426e508a5ced3a92715779bedabc"
}

失败返回示例：

{
  "request_id": "TID2af751b4bff24be781d60af10bf84101",
  "code": "1000",
  "msg": "验签失败",
  "charge": 2
}

4.业务响应码