創建域名
更新時間 2024-10-24 18:01:26
最近更新時間: 2024-10-24 18:01:26
分享文章
接口功能介紹
支持直播推流、拉流域名的創建。
使用說明
- 添加域名之前，您需要先開通對應產品類型的服務；
- 該域名必須已成功備案；
- 該域名之前未創建過，沒有在途工單；
- 單個用戶一分鐘限制調用10次。
- 視頻直播產品的域名分3種場景，①新增推流域名；②新增拉流域名，且拉流模式為推拉流；③新增拉流域名，且拉流模式為回源拉流
接口詳情
請求方式：POST
請求路徑：/live/domain/create-domain
請求參數
場景1：創建推流域名
| 參數 | 類型 | 名稱 | 是否必填 | 說明 |
|---|---|---|---|---|
| product_code | string | 產品類型 | 是 | "005"：視頻直播 |
| domain | string | 域名 | 是 | 推流域名 |
| conf_type | int | 域名類型 | 是 | 固定值：2（直播推流） |
場景2：創建拉流域名（推拉流場景）
| 參數 | 類型 | 名稱 | 是否必填 | 說明 |
|---|---|---|---|---|
| product_code | string | 產品類型 | 是 | "005"：視頻直播 |
| domain | string | 域名 | 是 | 拉流域名 |
| conf_type | int | 域名類型 | 是 | 固定值：1（直播拉流） |
| pull_stream_mode | int | 拉流模式 | 是 | 固定值：0（推拉流） |
| push_stream_domain | string | 關聯推流域名 | 是 | 已創建的推流域名 |
場景3：創建拉流域名（回源拉流場景）
| 參數 | 類型 | 名稱 | 是否必填 | 說明 |
|---|---|---|---|---|
| product_code | string | 產品類型 | 是 | "005"：視頻直播。 |
| domain | string | 域名 | 是 | 拉流域名。 |
| conf_type | int | 域名類型 | 是 | 1（直播拉流）。 |
| pull_stream_mode | int | 拉流模式 | 是 | 1（回源拉流）。 |
| rtmp_origin | list | rtmp協議回源參數 | 否 | rtmp_origin，flv_origin，flv_https_origin，hls_http_origin，hls_https_origin 5個為回源功能組，必填其中一個，可多個。 |
| rtmp_origin[*].origin | string | 協議地址 | 是 | 當rtmp_origin有值時，該字段必填。 |
| flv_origin | list | flv協議http回源參數 | 否 | rtmp_origin，flv_origin，flv_https_origin，hls_http_origin，hls_https_origin 5個為回源功能組，必填其中一個，可多個。 |
| flv_origin[*].origin | string | 協議地址 | 是 | 當flv_origin有值時，該字段必填。 |
| flv_https_origin | list | flv協議https回源參數 | 否 | rtmp_origin，flv_origin，flv_https_origin，hls_http_origin，hls_https_origin 5個為回源功能組，必填其中一個，可多個。 |
| flv_https_origin[*]origin | str | flv協議地址 | 是 | 當flv_https_origin有值時，該字段必填，支持ipv4、ipv6、域名 |
| hls_http_origin | list | hls協議回源參數 | 否 | rtmp_origin，flv_origin，flv_https_origin，hls_http_origin，hls_https_origin 5個為回源功能組，必填其中一個，可多個。 |
| hls_http_origin[*].origin | string | 源站 | 是 | 當hls_http_origin有值時，該字段必填。 |
| hls_https_origin | list | hls協議https回源參數 | 否 | rtmp_origin，flv_origin，flv_https_origin，hls_http_origin，hls_https_origin 5個為回源功能組，必填其中一個，可多個。 |
| hls_https_origin[*]origin | str | 源站 | 是 | 當hls_https_origin有值時，該字段必填，支持ipv4、ipv6、域名 |
| distribution_protocol | string | 播放協議 | 是 | 可以為flv，rtmp，hls, 多個以英文逗號隔開。 |
響應參數
| 參數 | 類型 | 說明 |
|---|---|---|
| code | int | 狀態碼 |
| message | string | 描述信息 |
示例
請求路徑：//cdnapi-global.ctapi.daliqc.cn/live/domain/create-domain
請求示例
示例1：創建推流域名
{
"product_code":"005",
"domain":"push.daliqc.cn",
"conf_type":2
}
示例2：創建拉流域名（推拉流場景）
{
"product_code":"005",
"domain":"pull.daliqc.cn",
"conf_type":1,
"pull_stream_mode":0,
"push_stream_domain":"push.daliqc.cn"
}
示例3：創建拉流域名（回源拉流場景）
{
"product_code":"005",
"domain":"daliqc.cn",
"conf_type":1,
"pull_stream_mode":1,
"distribution_protocol":"hls",
"rtmp_origin":[{"origin":"rtmp.ctyun.com"}]
}
正常響應示例
{
"code": 100000,
"message": "success"
}
錯誤碼請參考：API返回參數code和message含義
