接口功能介绍
配置直播触发拉流。
使用说明
- 拉流是将第三方直播流地址拉取到天翼云直播中心进行加速分发的过程。
- 本接口支持触发拉流,即当需要拉取的源站开始播放直播流时,自动触发天翼云视频直播服务进行拉流直播。
- 单个用户一分钟限制调用100次。
接口详情
请求方式:POST
请求路径:/live/preload/set-preload
请求参数
参数名 | 类型 | 名称 | 是否必填 | 说明 |
---|---|---|---|---|
type | string | 任务类型 | 是 | 可选参数为 hls或flv。 hls: http hls直播流;flv:http/flv直播流。 |
url | string | 拉流URL | 是 | 支持hls,http/flv请求url。需要带协议头(例如http://)且包含域名发布点和流名。 |
duration | int | 持续时长 | 是 | 预拉取的时长,范围为分钟。取值范围 10分钟-600分钟。 |
响应参数
字段名称 | 类型 | 说明 |
---|---|---|
code | int | 当code=100000则提交成功,其他失败 |
message | string | 当code != 100000时,显示错误信息 |
task_id | string | 任务ID |
示例
请求路径:https://cdnapi-global.ctapi.ctyun.cn/live/preload/set-preload
请求示例
{
"type":"hls",
"url":"ctyun.cn",
"duration":600
}
正常响应示例
{
"code": 100000,
"message": "success",
"task_id": "601363113098346496"
}
错误码请参考:参数code和message含义