接口功能介绍
更新直播拉流配置信息。
使用说明
更新直播拉流配置。单个用户一分钟限制调用100次。
接口详情
请求方式：POST
请求路径：/live/preload/update-preload
请求参数
| 参数名 | 类型 | 名称 | 是否必填 | 说明 |
|---|---|---|---|---|
| type | string | 任务类型 | 是 | 可选参数为 hls或flv。 hls: http hls直播流；flv：http/flv直播流。 |
| task_id | string | 任务id | 是 | 需要修改的任务id |
| 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/update-preload
请求示例
{
"type":"flv",
"task_id":"598832427460198400",
"url":"ctyun.cn",
"start_time":"2022-11-17 18:13:00",
"end_time":"2022-11-17 19:50:00"
}
正常响应示例
{
"code": 100000,
"message": "success",
"task_id": "599561104552624128"
}
错误码请参考：参数code和message含义
