修改視頻信息
更新時間 2025-04-16 10:39:50
最近更新時間: 2025-04-16 10:39:50
分享文章
通過本接口修改媒體庫的視頻條目信息。
接口功能介紹
用戶可通過本接口修改媒體庫的視頻條目信息。
接口約束
本接口的單用戶QPS限制為20次/秒。超過限制，API調用會被限流，這可能會影響您的業務，請合理調用。
URI
POST /video/update
請求體body參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| videoId | 是 | String | 視頻ID | 34c71dba-f280-4f5e-a05f-f4daed837fef | |
| name | 否 | String | 視頻的名稱，如果不傳入則不修改。 | 我的視頻 | |
| remark | 否 | String | 視頻簡介，如不傳入則不修改，注意：傳入空字符串也會修改為空。 | "備注" | |
| tags | 否 | Array of Strings | 視頻標簽，不傳入則不修改，注意：傳入空列表或者空字符串將會刪除所有標簽。 | ["愛情片", "歷史片"] | |
| categoryId | 否 | Integer | 視頻分類ID。不傳默認將該視頻分類為【未分類】。 | 10000600098 |
響應參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| code | 是 | Integer | 本次請求的結果碼。 | 0 | |
| message | 是 | String | 錯誤文本信息，執行成功時，為空字符串。 | "" |
請求示例
{
"videoId": "34c71dba-f280-4f5e-a05f-f4daed837fef",
"name": "我的視頻",
"remark": "備注",
"tags": ["愛情片", "歷史片"],
"categoryId":10000600098
}
響應示例
{
"code": 0,
"message": ""
}
狀態碼
| Http 狀態碼 | 狀態碼信息 | 狀態碼描述 |
|---|---|---|
| 0 | 表示業務成功 | 表示業務成功 |
| 400 | 請求參數有誤 | 請求參數有誤 |
| 403 | 用戶鑒權失敗，用戶無操作權限 | 用戶鑒權失敗，用戶無操作權限 |
| 404 | 請求的資源不存在，輸入錯誤的URL | 請求的資源不存在，輸入錯誤的URL |
| 500 | 業務執行異常 | 業務執行異常 |
錯誤碼
OpenAPI錯誤碼請參考 錯誤碼說明。
