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 | \ No newline at end of file | 101 | \ No newline at end of file |