概述

版本: 2.9.0
日期: 2021-01-14

相关说明

利用Live API 可以与CC直播进⾏对接，使用直播系统的主要功能。 目前Live API 仅对合作⽅开启，如果您有使用的需求，请通过CC直播后台获取API Key。

通信约定

Live API 的远程通信接口基于 HTTP 协议，并有以下约定：

HTTP方法

所有接口如没特别说明均采用 GET 请求，同一账号接口请求次数上限为200次/分钟。

返回格式

接口的返回格式为JSON 格式，编码均为 UTF-8。对于不同的接口，正确的返回结果的格式会在每个接口中单独定义，错误的返回结果具有统一的形式，如下所示:

{
    "result": "FAIL",
    "reason": "错误原因"
}

错误原因对照表：

编码格式

Live API 只接受 UTF-8 格式编码的信息，返回的数据也都是 UTF-8 编码的。当需要通过 GET 请求传递参数时，QueryString 里面的 value 值都需要进行 URL Encode 之后，再进行THQS加密。

加密

所有的 HTTP 通信都是加密的，加密的核心思想是将原始的 QueryString 转换为和请求时间相关的 HashedQueryString，我们称这个加密算法为 THQS 算法。关于 THQS 算法的细节请参见HTTP通信加密算法。

接口请求参数

所有接口请求参数如果没有特别说明都是必填项。

直播间模板类型及说明