Commit 120d99b2de625399f175d69b30cb30c2c9b00e97

Authored by LSL
2 parents 9eef217f b971e8f0

Merge remote-tracking branch 'origin/master'

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
... ...