视频点播

产品文档

视频点播

listCategories

描述

查询分类列表。按照分页方式,返回分类列表信息。

请求方式

GET

请求地址

https://vod.jdcloud-api.com/v1/categories

请求参数

名称 类型 是否必需 默认值 描述
pageNumber Integer False 1 页码;默认值为 1
pageSize Integer False 10 分页大小;默认值为 10;取值范围 [10, 100]
sorts Sort[ ] False

Sort

名称 类型 是否必需 默认值 描述
name String False 排序属性名
direction String False 排序方向

返回参数

名称 类型 描述
result Result 查询分类列表信息结果.....
requestId String 请求ID

Result

名称 类型 描述
pageNumber Integer 当前页码
pageSize Integer 每页数量
totalElements Integer 查询总数
totalPages Integer 总页数
content CategoryObject[ ] 分页内容

CategoryObject

名称 类型 描述
id Long 分类ID
name String 分类名称
level Integer 分类级别。取值范围为 [0, 3],取值为 0 时为虚拟根节点
parentId Long 父分类ID,取值为 0 或 null 时,表示该分类为一级分类
description String 分类描述信息
createTime String 创建时间
updateTime String 修改时间

返回码

返回码 描述
200 OK
401 Authentication failed
500 Internal server error
503 Service unavailable

请求示例

GET

https://vod.jdcloud-api.com/v1/categories

返回示例

{
    "requestId": "bgvmivir54gddpgi764se9f4kfr7ge41", 
    "result": {
        "content": [
            {
                "createTime": "2019-04-16T15:51:32Z", 
                "description": "description", 
                "id": 1, 
                "level": 0, 
                "name": "TV", 
                "parentId": 0, 
                "updateTime": "2019-04-16T15:51:32Z"
            }
        ], 
        "pageNumber": 1, 
        "pageSize": 10, 
        "totalElements": 1, 
        "totalPages": 1
    }
}
更新时间:2020-01-16 15:45:16
文档反馈 docs feedback