2.1 获取内容列表接口.md 5 KB

;/* Title: 1.1 获取内容信息接口 */

接口描述

接口协议

HTTP GET

接口请求参数

参数名 参数类型 必选 参数说明
appId string true 应用ID
page int false 页号,如为空,默认值:1
pageSize int false 每页返回条数,如为空,默认值:20
verTimestamp long false 时间戳 时间毫秒值,返回最后修改时间在此时间之后的所有内容
groupType string false 内容分组:program(视音频)、richtxt(非视音频)等;
categoryName string false 分类名称
timestamp int true 精确到秒,当前Unix时间戳,请保证请求服务器时间正确,该时间用于签名
sign String true 签名规则见 签名详情

返回值

参数名 参数类型 必选 参数说明
errorCode int true 错误类型号
errorMessage string true 错误类型
totalNum long true 总条数
nextCursor long true 下一页
previousCursor long true 上一页
uuid string true 内容的唯一标识
title string true 内容标题
status string true 发布状态1、上线 0、下线
subTitle string false 内容副标题
albumName string false 专辑名称
albumId string false 专辑id
director string false 导演
actors string false 演员
screenwriter string false 编剧
filmProduce string false 制片人
desc string false 内容描述
categoryId string true 分类Id
categoryName string false 分类名称
tag string false 标签,多个以 逗号分隔
rates string true 仅对视频码率格式,多种码率用逗号隔开,码率分别定义为:1:流畅;2:清晰;3:高清;4:超清
cpName string true 所属cp, 没有所属CP的,用SPName代替
createDate string true 内容创建时间
publishTime string true 内容发布时间
verTimestamp long true 最后修改时间,时间戳 时间毫秒值
img map false 内容图片信息
groupImg map false 组图图片信息,仅对组图内容有效
groupType string true 内容分组:program(视音频)、richtxt(非视音频)等;
contentType string true program内容类型:video、live、audio;richtxt内容类型pics、article、vtxt、spectxt、picstxt
注意:某节目可能被检索2次,即一个video类型,一个vtxt类型。
bodyContent string false 富文本内容
columnTagId string true 栏目标签Id
columnTagName string false 栏目标签名称
extension1 string false 扩展字段

返回JSON格式的节目元数据信息,json示例如下:

{
    "errorCode": 0,
    "errorMessage": "成功",
    "data": {
        "programs": [
            {
                "uuid": "60_d57ad6f690cd4d4899cf56eb32512c19",
                "title": "黄家驹宣传片",
                "categoryId": "100001/72/73",
                "categoryName": "电影/喜剧/电影喜剧子分类",
                "desc": "黄家驹宣传片",
                "img": [
                    {
                        "format": "485*303",
                        "url": "http://y2017.qn.cnliveimg.com/60/img/2017/0818/ff8080815def9dcb015df428048800e6/000006.jpg?imageView2/1/w/485/h/303",
                    },
                    {
                        "format": "224*126",
                        "url": "http://y2017.qn.cnliveimg.com/60/img/2017/0818/ff8080815def9dcb015df428048800e6/000006.jpg?imageView2/1/w/224/h/126",
                    }
                ],
                "groupImg":[
                    {
                        "imgInfo":[
                            {
                              "format": "224*126",
                              "url": "http://y2017.qn.cnliveimg.com/60/img/2017/0818/ff8080815def9dcb015df428048800e6/000006.jpg?imageView2/1/w/224/h/126"
                            },
                            {
                              "format": "640*320",
                              "url": "http://y2017.qn.cnliveimg.com/60/img/2017/0818/ff8080815def9dcb015df428048800e6/000006.jpg?imageView2/1/w/224/h/126"
                            }
                        ]
                        "desc": ""
                    }
                ]
                "rates": "2",
                "cpName": "测试账号",
                "subTitle": "",
                "tag": "黄家驹宣传片",
                "createDate": "2017-08-18",
                "verTimestamp": 1508320723191
            }
        ],
        "totalNum": 1,
        "nextCursor": 0,
        "previousCursor": 0
    }
}