Commit 120d99b2de625399f175d69b30cb30c2c9b00e97
Merge remote-tracking branch 'origin/master'
Showing
1 changed file
with
100 additions
and
0 deletions
12.内容库云/2.1 获取内容列表接口.md
0 → 100644
| 1 | +;/* | |
| 2 | +Title: 1.1 获取内容信息接口 | |
| 3 | +*/ | |
| 4 | + | |
| 5 | +### 接口描述 ### | |
| 6 | + | |
| 7 | +### 接口协议 ### | |
| 8 | +HTTP GET | |
| 9 | + | |
| 10 | +### 接口请求参数### | |
| 11 | +|参数名| 参数类型 | 必选 | 参数说明 | | |
| 12 | +|:----- | :------: | :------: | :------: | | |
| 13 | +|appId| string | true | 应用ID | | |
| 14 | +|timestamp| int | true | 精确到秒,当前Unix时间戳,请保证请求服务器时间正确,该时间用于签名| | |
| 15 | +|sign| String | true | 签名规则见 [签名详情] (http://console.open.cnlive.com/open/doc/sys/dianbo/t1/00.%E5%85%AC%E5%85%B1%E7%BB%84%E4%BB%B6/1.1%20SHA1%E7%AD%BE%E5%90%8D) | | |
| 16 | +|keyword| string | false | 关键词 | | |
| 17 | +|categoryId| int | false | 分类Id,从分类树接口中取。 categoryId 和spId 不能同时为空 根分类7个是常量,每个SP都有,分别如下:电影100001电视剧100002;娱乐100004;资讯100008;体育100012;教育100016;其他100026| | |
| 18 | +|page| int | false | 页号,如为空,默认值:1 | | |
| 19 | +|pageSize| int | false | 每页返回条数,如为空,默认值:20 | | |
| 20 | +|verTimestamp| long | false | 时间戳 时间毫秒值,返回最后修改时间在此时间之后的所有内容 | | |
| 21 | + | |
| 22 | +### 返回值 ### | |
| 23 | + | |
| 24 | +| 参数名 | 参数类型 | 必选 | 参数说明 | | |
| 25 | +| :-----------| :------: | :------: | :------: | | |
| 26 | +| errorCode| int | true | 错误类型号 | | |
| 27 | +| errorMessage| string | true | 错误类型 | | |
| 28 | +| totalNum| long | true | 总条数 | | |
| 29 | +| nextCursor| long | true | 下一页 | | |
| 30 | +| previousCursor| long | true | 上一页 | | |
| 31 | +| uuid| string | true | 节目的唯一标识 | | |
| 32 | +| title| string | true | 节目标题 | | |
| 33 | +| subTitle| string | false | 节目副标题 | | |
| 34 | +| desc| string | false | 节目描述 | | |
| 35 | +| categoryId| int | true | 分类Id | | |
| 36 | +| categoryName| string | false | 分类名称 | | |
| 37 | +| tag| string | false | 标签,多个以 逗号分隔 | | |
| 38 | +| rates| string | true | 视频码率格式,多种码率用逗号隔开,码率分别定义为:1:流畅;2:清晰;3:高清;4:超清 | | |
| 39 | +| cpName| string | true | 所属cp, 没有所属CP的,用SPName代替 | | |
| 40 | +| createDate| string | true | 内容创建时间 | | |
| 41 | +| verTimestamp| long | true | 最后修改时间,时间戳 时间毫秒值 | | |
| 42 | +| img| map | false | 内容图片信息| | |
| 43 | +| groupImg| map | false |组图图片信息,仅对组图内容有效 useType: 1分辨率最小的,多分辨率依次递增| | |
| 44 | + | |
| 45 | + | |
| 46 | +返回JSON格式的节目元数据信息,json示例如下: | |
| 47 | + | |
| 48 | +``` json | |
| 49 | +{ | |
| 50 | + "errorCode": 0, | |
| 51 | + "errorMessage": "成功", | |
| 52 | + "data": { | |
| 53 | + "programs": [ | |
| 54 | + { | |
| 55 | + "uuid": "60_d57ad6f690cd4d4899cf56eb32512c19", | |
| 56 | + "title": "黄家驹宣传片", | |
| 57 | + "categoryId": "100001/72/73", | |
| 58 | + "categoryName": "电影/喜剧/电影喜剧子分类", | |
| 59 | + "desc": "黄家驹宣传片", | |
| 60 | + "img": [ | |
| 61 | + { | |
| 62 | + "format": "485*303", | |
| 63 | + "url": "http://y2017.qn.cnliveimg.com/60/img/2017/0818/ff8080815def9dcb015df428048800e6/000006.jpg?imageView2/1/w/485/h/303", | |
| 64 | + }, | |
| 65 | + { | |
| 66 | + "format": "224*126", | |
| 67 | + "url": "http://y2017.qn.cnliveimg.com/60/img/2017/0818/ff8080815def9dcb015df428048800e6/000006.jpg?imageView2/1/w/224/h/126", | |
| 68 | + } | |
| 69 | + ], | |
| 70 | + "groupImg":[ | |
| 71 | + { | |
| 72 | + "imgInfo":[ | |
| 73 | + { | |
| 74 | + "format": "224*126", | |
| 75 | + "url": "http://y2017.qn.cnliveimg.com/60/img/2017/0818/ff8080815def9dcb015df428048800e6/000006.jpg?imageView2/1/w/224/h/126", | |
| 76 | + "useType":"1" //使用方式 | |
| 77 | + }, | |
| 78 | + { | |
| 79 | + "format": "640*320", | |
| 80 | + "url": "http://y2017.qn.cnliveimg.com/60/img/2017/0818/ff8080815def9dcb015df428048800e6/000006.jpg?imageView2/1/w/224/h/126", | |
| 81 | + "useType":"2" | |
| 82 | + } | |
| 83 | + ] | |
| 84 | + "desc": "" | |
| 85 | + } | |
| 86 | + ] | |
| 87 | + "rates": "2", | |
| 88 | + "cpName": "测试账号", | |
| 89 | + "subTitle": null, | |
| 90 | + "tag": "黄家驹宣传片", | |
| 91 | + "createDate": "2017-08-18", | |
| 92 | + "verTimestamp": 1508320723191 | |
| 93 | + } | |
| 94 | + ], | |
| 95 | + "totalNum": 1, | |
| 96 | + "nextCursor": 0, | |
| 97 | + "previousCursor": 0 | |
| 98 | + } | |
| 99 | +} | |
| 100 | +``` | |
| 0 | 101 | \ No newline at end of file | ... | ... |