Commit 24583dbc30759318d3f81c064c011c84aa4f4984

Authored by 张奎
1 parent f658443f

合并多次提交

定义入库接口

修改

修改

update

update

添加扩展字段
12.内容库云/1.0 内容云入库接口.md 0 → 100644
  1 +/*
  2 +Title: 1.1 内容云入库接口
  3 +*/
  4 +
  5 +### 接口描述 ###
  6 +
  7 +
  8 +### 接口地址 ###
  9 +http://api.cnlive.com/open/api2/nry/add
  10 +
  11 +### 接口协议 ###
  12 +HTTP POST
  13 +
  14 +### 接口请求参数 ###
  15 +|参数名| 参数类型 | 必选 | 参数说明 |
  16 +|:----- | :------: | :------: | :------: |
  17 +|source| string | true | 来源:mam、live、cms、ring7、chinaorg等 |
  18 +| uuid | string | true | 内容标识, 确保唯一来源下,此内容ID唯一,视讯云点播云用globalId,cms可用contentId。 |
  19 +| subUuid | string | false | 附属内容标识, 主要用于富文本的vtxt而言,即用此参数来区别,发布云为uuid,点播云为globalId |
  20 +| groupType | string | true | 组类型:program、richtxt等 ,内容分组:节目(来源于媒资库)、富文本(来自CMS或图片库等) |
  21 +| contentType | string | true | 内容类型:video、live、audio、pics、article等 ,<br/>内容类型(需要设计6个小的icon,便于内容结果展示的标示):<br/>节目分下含:video(默认1)、live、audio<br/>富文本含:article(默认0)、vtxt、spectxt、picstxt<br/>注意:某节目可能被检索2次,即一个video类型,一个vtxt类型。 |
  22 +| spId | string | true | |
  23 +| spName | string | false | |
  24 +| cpId | string | true | cp标识 |
  25 +| cpName | string | false | |
  26 +| status | string | true | 上线状态, 1=上线,0下线,-1为删除。(0和-1是支持内部生产的查询) |
  27 +| title | string | true | 内容标题 |
  28 +| subTitle | string | true | 内容副标题 |
  29 +| categoryId | string | true | 分类标识,全路径,用’\‘隔开 |
  30 +| categoryName | string | true | 全路径,用’\‘隔开 |
  31 +| editorId | string | false | 编辑标识 |
  32 +| editorName | string | false | 编辑名称 |
  33 +| keywords | string | false | 关键词 |
  34 +| pageUrl | string | false | 内容的页面地址 |
  35 +| description | string | false | 描述 |
  36 +| bodyContent | string | false | 文本内容,含html代码,传输时注意编码 |
  37 +| copyrightId | string | true | 版权标识,唯一标示,来自 统一的 内容版权管理系统(建议暂时editorid来标示) |
  38 +| imgJson | string | true | 图片:json格式 |
  39 +| director | string | false | 导演 |
  40 +| actors | string | false | 演员 |
  41 +| albumName | string | false | 专辑名称 |
  42 +| area | string | true | 地区 |
  43 +| year | string | true | 年代 |
  44 +| createTime | string | true | 创建时间 |
  45 +| publishTime | string | true | 发布时间 |
  46 +| verTimestamp | string | true | 时间戳版本 |
  47 +| weight | string | true | 权重, 取值:0 ~ 100 |
  48 +| extensions1 | string | true | 创建时间 |
  49 +| extensions2 | string | true | 创建时间 |
  50 +| extensions3 | string | true | 扩展字段:json格式 |
  51 +
  52 +
  53 +### 返回值 ###
  54 +
  55 +| 参数名 | 参数类型 | 必选 | 参数说明 |
  56 +| :-----------| :------: | :------: | :------: |
  57 +| errorCode| int | true | 错误类型号 |
  58 +| errorMessage| string | true | 错误类型 |
  59 +
  60 +请求JSON格式的节目元数据信息,json示例如下:
  61 +
  62 +``` json
  63 +{
  64 + "source":"mam",
  65 + "uuid":"82_17cbfede6f074db18d06fdeb170e41c4",
  66 + "subUuid":"82_17cbfede6f074db18d06fdeb170e41c4",
  67 + "groupType":"program",
  68 + "contentType":"video",
  69 + "spId":"82",
  70 + "spName":"视讯中国",
  71 + "cpId":"1",
  72 + "cpName":"",
  73 + "status":"1",
  74 + "title":"李雨桐风波后首度亮相心情好",
  75 + "subTitle":"李雨桐风波后心情好",
  76 + "categoryId":"001/123",
  77 + "categoryName":"娱乐/港台",
  78 + "editorId":"123",
  79 + "editorName":"李四",
  80 + "keywords":"刘德华/关之琳",
  81 + "pageUrl":"http://www.cnlive.com/yule/1234.html",
  82 + "description":"李雨桐风波后首度亮相心情好,风波后首度亮相心情好。",
  83 + "bodyContent":"",
  84 + "copyrightId":"1",
  85 + "director":"冯小刚",
  86 + "actors":"葛优",
  87 + "albumName":"专题1",
  88 + "area":"大陆",
  89 + "year":"90",
  90 + "createTime":"2017-10-12 11:12:01",
  91 + "publishTime":"1998-05-12 09:16:20",
  92 + "verTimestamp":"2017-10-12 11:12:01",
  93 + "weight":"60",
  94 + "extensions1":"",
  95 + "extensions2":"",
  96 + "extensions3":{
  97 + "albumPrgCounts":"20",
  98 + "albumPrgSeqNo":"1",
  99 + "durationBySec":"209",
  100 + "language":"汉语"
  101 + },
  102 + "imgJson":[
  103 + {
  104 + "type":"titleImage",
  105 + "format":"316*506",
  106 + "url":"http://test.qnvod.cnlive.com/60/img/2017/0809/ff8080815dc0be57015dc4c1fe380061/000002.jpg?imageView2/1/w/316/h/506",
  107 + "desc":"图片介绍"
  108 + },
  109 + {
  110 + "type":"contentImage",
  111 + "format":"485*303",
  112 + "url":"http://test.qnvod.cnlive.com/60/img/2017/0809/ff8080815dc0be57015dc4c1fe380061/000002.jpg?imageView2/1/w/224/h/398",
  113 + "desc":"图片介绍"
  114 + }
  115 + ]
  116 +}
  117 +```
  118 +
  119 +返回JSON格式的节目元数据信息,json示例如下:
  120 +
  121 +``` json
  122 +{
  123 + "data":{
  124 + "uuid":"17cbfede6f074db18d06fdeb170e41c4",
  125 + "title":"一带一路特别节目"
  126 + },
  127 + "errorCode":0,
  128 + "errorMessage":"sucess"
  129 +}
  130 +```
0 131 \ No newline at end of file
... ...
12.内容库云/1.0 内容库查询接口.md renamed to 12.内容库云/1.1 内容云查询接口.md