接口功能介绍
支持直播转码、直播录制和直播截图等媒体处理功能模板绑定、解绑。
使用说明
(1)需先新增媒体处理模板,再调用此接口进行模板的绑定
(2)可通过查询媒体处理模板列表接口,查询已新增的媒体处理模板信息
(3)可通过查询域名媒体处理配置查询域名已绑定的模板配置,以免重复绑定
接口详情
请求方式:POST
请求路径:/live/media-template/bind-media-template
请求JSON参数
参数名 | 类型 | 名称 | 是否必填 | 说明 |
---|---|---|---|---|
Option | int | 操作 | 是 | 取值说明: 1:绑定 0:解绑 |
domain | string | 域名 | 是 | 一次只能提交1个域名 |
app_name | string | 频道名 | 否 | 即发布点 支持精确匹配和模糊匹配(支持字母、数字、-,但不能直接传**) 长度限制为128个字符 示例: 1、精确匹配频道名,示例:live 2、模糊匹配频道名,示例:live** 不传或传空则绑定到域名粒度。 |
stream_name | string | 流名 | 否 | 流名 支持精确匹配和模糊匹配(支持字母、数字、- ,但不能直接传 *) 长度限制为128个字符 示例: 1、精确匹配流名,示例:StreamA 2、模糊匹配,示例:StreamA 如果请求入参中有stream_name时,则app_name为必填。 不传或者传空则绑定到域名或者发布点粒度。 |
media | list | |||
media:type | string | 模板类型 | 是 | live-tran: 直播转码 live-record: 直播录制 live-snapshot: 直播截图 live-identify:直播审核 |
media:id | string | 模板ID | 是 | 已创建的回调模板ID,多个模板ID使用英文逗号分隔 |
响应JSON参数
参数名 | 类型 | 名称 |
---|---|---|
code | int | 状态码 |
message | string | 描述信息 |
示例
请求路径:https://cdnapi-global.ctapi.ctyun.cn/live/media-template/bind-media-template
请求JSON示例
{
"Option":0,
"domain":"ctyun.cn",
"app_name":"livetest",
"stream_name":"streamtest",
"media": [{"id": "65shhklue975easaa457", "type": "live-tran"}]
}
正常返回JSON示例
{
"code": 100000,
"message": "success"
}