SDK配合调用接口

• 1. get_token
• 2. liveness_video

1./v2/sdk/get_token

• 1.1 接口描述
• 1.2 请求参数
• 1.3 返回参数
• 1.4 错误码
• 1.5 输入示例

1.1 接口描述

该API的功能是配合活体检测SDK使用，在SDK启动前获取token，get_token 接口是与 liveness_auth 配对使用的，使用get_token 获取token，活体检测初始化时调用liveness_auth 对token进行验证

请求方式

POST

请求 URL

https://cloudapi.linkface.cn/v2/sdk/get_token

1.2 请求参数

所有中文和特殊字符必需以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();
    }

1.3 返回参数

data详情：

输出示例:

成功返回示例：
{
    "request_id": "TID2af751b4bff24be781d60af10bf84101",
    "code": "0000",
    "msg": "调用成功",
    "data": {
        "token":"dstj2af751b4bff24be781d60af10bf84101"
    }
    "charge": 2
}
失败返回示例：
{
    "request_id": "TID2af751b4bff24be781d60af10bf84101",
    "code": "1008",
    "msg": "服务无权限",
    "charge": 2
}

1.4 错误码

1.5 输入示例

• cURL 样例

curl -X POST "https://cloudapi.linkface.cn/v2/sdk/get_token?sequence_id=SEQUENCE&api_id=ID"  -F detection_type=DETECTION -F timestamp=TIMESTAMP -F sign=SIGN

2./v2/sdk/liveness/liveness_video

• 2.1 接口描述
• 2.2 请求参数
• 2.3 返回参数
• 2.4 错误码
• 2.5 输入示例

2.1 接口描述

该API功能为返回活体检测成功后的视频下载地址。

请求方式

POST

请求 URL

https://cloudapi.linkface.cn/v2/sdk/liveness/liveness_video

2.2 请求参数

2.3 返回参数

收费标准：code为0000，charge为1时收费；其他情况（code非0000），charge为2，不收费；

data详情：

输出示例：

成功返回示例：
{
    "request_id": "TID2af751b4bff24be781d60af10bf84101",
    "code": "0000",
    "msg": "成功",
    "data": {
        "url": "        ...      ",
    }
    "charge": 1
}

失败返回示例：
{
    "request_id": "TID2af751b4bff24be781d60af10bf84101",
    "code": "1000",
    "msg": "验签失败",
    "charge": 2
}

2.4 错误码

2.5 输入示例

• cURL 样例

curl -X POST "https://cloudapi.linkface.cn/v2/sdk/liveness/liveness_video?sequence_id=SEQUENCE&api_id=ID" -F timestamp=TIMESTAMP -F sign=SIGN -F video_id=VIDEO_ID