/v2/liveness/check_silent_liveness

• 1.接口描述
• 2.请求参数
• 3.返回参数
• 4.错误码
• 5.输入示例

1.接口描述

对用户拍摄的视频进行静默活体检测

请求方式

POST

请求 URL

https://cloudapi.linkface.cn/v2/liveness/check_silent_liveness

2.请求参数

注释：

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

请求参数 liveness_data_file与liveness_data_url二选一。

目前支持 http/https 等协议的网络地址。下载限时 10s，超时后仍未下载完成则属于失败。

视频支持格式：AVI、wma、rmvb、rm、flash、mp4、3GP。

签名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数组中字段的结构：

备注：

score阈值推荐为0.98，由行业大数据训练得到，大于0.98为静默活体不通过，小于等于0.98为静默活体通过。

只有code为0000时收费，charge为1；code为其他值时，不收费，charge为2；输出样例：

返回样例

{
  "request_id": "TID2af751b4bff24be781d60af10bf84103",
  "code": "0000",
  "msg":"请求成功",
  "data":{
      "score": "0.764158124513453",
      "feature_image_id": "xxxxxx"
  }
  "charge": "1",  
}

4.业务响应码

返回样例

{
  "request_id": "TID2af751b4bff24be781d60af10bf84103",
  "code": "1002",
  "msg":"请求参数错误",
  "charge": "2",  
}