接口功能介绍
添加直播拉流配置信息。
使用说明
- 拉流是将第三方直播流地址拉取到天翼云直播中心进行加速分发的过程。
- 本接口支持提前设定时间拉流,即指定拉流的起始时间和结束时间,在指定时间进行拉流直播。
- 单个用户一分钟限制调用100次。
接口详情
请求方式:POST
请求路径:/live/preload/create-preload
请求参数
参数名 | 类型 | 名称 | 是否必填 | 说明 |
---|---|---|---|---|
type | string | 任务类型 | 是 | 可选参数为 hls或flv。 hls: http hls直播流;flv:http/flv直播流。 |
url | string | 拉流URL | 是 | 支持hls,http/flv请求url。需要带协议头(例如http://)且包含域名发布点和流名。 |
start_time | string | 预拉取的起始时间 | 是 | 时间格式:"2019-05-21 18:03:48",开始时间不能小于当前时间。 |
end_time | string | 预拉取的结束时间 | 是 | 预拉取的结束时间,时间格式:"2019-05-21 18:03:48" 。end_time<当前时间或者end_time-start_time<10分钟 会返回失败。 如果有起始时间没有结束时间,一直拉取,直到任务被停止,或者超时范围内没有拉到流,回调任务停止或者任务失败 |
响应参数
字段名称 | 类型 | 说明 |
---|---|---|
code | int | 当code=100000则提交成功,其他失败 |
task_id | string | |
message | string | 当code != 100000时,显示错误信息 |
示例
请求路径:https://cdnapi-global.ctapi.ctyun.cn/live/preload/create-preload
请求示例
{
"type":"hls",
"url": "ctyun.cn",
"start_time":"2022-11-17 17:35:00",
"end_time":"2022-11-17 18:00:00"
}
正常响应示例
{
"code": 100000,
"message": "success",
"task_id": "599561104552624128"
}
错误码请参考:参数code和message含义