查询分类列表

接口描述

1、通过分类id分页查询分类列表
2、接口支持https协议

接口URL

http://api.polyv.net/v3/category/get

在线API调用arrow-up-right

请求方式

POST

接口约束

1、接口同时支持HTTP 、HTTPS ,建议使用HTTPS 确保接口安全,接口调用有频率限制,详细请查看arrow-up-right

请求参数描述

参数名
必选
类型
说明

appId

true

String

保利威点播子账户appId,获取路径:保利威点播后台->设置->账号管理

timestamp

true

Long

当前时间的毫秒级时间戳,3分钟内有效

sign

true

String

签名,为32位大写的MD5值【详见MD5签名生成规则arrow-up-right

cateId

true

Long

分类id,默认为1则查询所有分类列表

page

false

Integer

子分类列表页码

pageSize

false

Integer

子分类每页大小

示例

表单参数:

响应参数描述

参数名
类型
说明

requestId

String

每次请求的业务流水号,必须唯一,便于客户端/服务器端排查问题

code

Integer

响应状态码,200为成功返回,非200为失败【详见全局错误说明arrow-up-right

status

String

响应状态文本信息

error

Object

响应成功返回null,响应失败返回错误描述信息【详见error参数描述arrow-up-right

data

Object

响应成功时返回分类列表信息【详见data字段说明arrow-up-right

error参数描述

参数名
类型
说明

code

Integer

错误码

desc

String

错误描述

data参数描述

参数名
类型
说明

category

Object

当前分类信息【详见category字段说明arrow-up-right

subCategoryTotal

Integer

下一级子分类个数

subCategories

Array

下一级子分类列表【详见subCategories字段说明arrow-up-right

category参数描述

参数名
类型
说明

cateId

Long

分类id

cateName

String

分类名称

parentId

Long

上一级分类id

subCategories参数描述

参数名
类型
说明

cateId

Long

分类id

cateName

String

分类名称

parentId

Long

上一级分类id

Java请求示例

快速接入基础代码请下载相关依赖源码, 点击下载源代码arrow-up-right ,下载后加入到自己的源码工程中即可。测试用例中的HttpUtil.java 和 VodSignUtil.java 都包含在下载文件中。

强烈建议您使用点播Java SDKarrow-up-right完成API的功能对接,点播Java SDK 对API调用逻辑、异常处理、数据签名、HTTP请求线程池进行了统一封装和优化。

响应示例

系统全局错误说明详见全局错误说明arrow-up-right

成功示例

异常示例

时间戳错误

appId不正确

子账号不存在

子账号过期

签名错误

账号权限不足

分类不存在

Last updated