添加直播拉流配置
更新時間 2023-11-09 15:30:01
最近更新時間: 2023-11-09 15:30:01
分享文章
接口功能介紹
添加直播拉流配置信息。
使用說明
- 拉流是將第三方直播流地址拉取到天翼云直播中心進行加速分發的過程。
- 本接口支持提前設定時間拉流，即指定拉流的起始時間和結束時間，在指定時間進行拉流直播。
- 單個用戶一分鐘限制調用100次。
接口詳情
請求方式：POST
請求路徑：/live/preload/create-preload
請求參數
| 參數名 | 類型 | 名稱 | 是否必填 | 說明 |
|---|---|---|---|---|
| type | string | 任務類型 | 是 | 可選參數為 hls或flv。 hls: http hls直播流；flv：http/flv直播流。 |
| url | string | 拉流URL | 是 | 支持hls，http/flv請求url。需要帶協議頭(例如//)且包含域名發布點和流名。 |
| 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時，顯示錯誤信息 |
示例
請求路徑：//cdnapi-global.ctapi.daliqc.cn/live/preload/create-preload
請求示例
{
"type":"hls",
"url": "daliqc.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含義
