查詢視頻分類
更新時間 2025-04-16 10:39:53
最近更新時間: 2025-04-16 10:39:53
分享文章
查詢全部分類標簽。
接口功能介紹
通過本接口可查詢全部分類。請注意，每個視頻條目僅允許創建一組不超過三級的視頻分類。未創建視頻分類的視頻會自動歸屬于【未分類】的分類條目。創建、修改、刪除分類僅影響視頻分類的歸屬，不會影響視頻條目的主體數據（封面、截圖、視頻等）。
接口約束
本接口的單用戶QPS限制為20次/秒。超過限制，API調用會被限流，這可能會影響您的業務，請合理調用。
URI
GET /video/category
響應參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| code | 是 | Integer | 接口業務響應碼：0-查詢成功；非0-查詢失敗。 | 0 | -- |
| message | 是 | String | 查詢失敗時為具體失敗信息；成功時為""。 | "" | -- |
| data | 是 | Object | 返回數據集，當數據集為空時直接顯示 “未分類”。 | -- | data |
表data
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| id | 是 | Integer | 分類ID。 | 1000600001 | -- |
| name | 是 | String | 分類名稱。 | 國產電影 | -- |
| parentId | 是 | Integer | 關聯的parentId，如為0代表未分類，如為非0則代表本條目為parentId管理視頻條目的子條目。 | 1000600001 | -- |
| children | 否 | Object | 下級視頻分類條目，支持嵌套。目前同一視頻條目僅支持最多三級分類，即父-子-子。 | -- | children |
表children
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| id | 是 | Integer | 分類ID。 | 1000600001 | -- |
| name | 是 | String | 分類名稱。 | 2022年 | -- |
| parentId | 是 | Integer | 關聯的parentId，如為0代表未分類，如為非0則代表本條目為parentId管理視頻條目的子條目。 | 1000600001 | -- |
| children | 否 | Object | 下級視頻分類條目，支持嵌套。目前同一視頻條目僅支持最多三級分類，即父-子-子。 | -- | children |
請求示例
無
響應示例
{
"code":"0",
"message":"",
"data":[{
"id":1000600001,
"name":"電影",
"parentId":0,
"children":[{
"id":1000600013,
"name":"動作片",
"parentId":1000600001,
"children":[{
"id":100060020,
"name":"拳擊",
"parentId":1000600013
}]
}]
}]
}
狀態碼
| Http 狀態碼 | 狀態碼信息 | 狀態碼描述 |
|---|---|---|
| 0 | 表示業務成功 | 表示業務成功 |
| 400 | 請求參數有誤 | 請求參數有誤 |
| 403 | 用戶鑒權失敗，用戶無操作權限 | 用戶鑒權失敗，用戶無操作權限 |
| 404 | 請求的資源不存在，輸入錯誤的URL | 請求的資源不存在，輸入錯誤的URL |
| 500 | 業務執行異常 | 業務執行異常 |
錯誤碼
OpenAPI錯誤碼請參考 錯誤碼說明。
