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

Edit Raw Blame History


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


接口描述


接口地址

https://api.cnlive.com/open/api2/cbase/select


接口协议

HTTP GET


接口请求参数 json 格式


参数名
参数类型
必选
参数说明


appId
string
true
应用ID


keyword
string
false
关键词


categoryId
int
false
分类Id,从分类树接口中取。 categoryId 和spId 不能同时为空 根分类7个是常量，每个SP都有,分别如下：电影100001电视剧100002;娱乐100004;资讯100008;体育100012;教育100016;其他100026


page
string
false
页号，如为空，默认值：1


pageSize
string
false
每页返回条数，如为空，默认值：20


verTimestamp
long
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
节目标题


subTitle
string
false
节目副标题


desc
string
false
节目描述


categoryId
int
true
分类Id


categoryName
string
false
分类名称


tag
string
false
标签，多个以 逗号分隔


rates
string
true
视频码率格式，多种码率用逗号隔开，码率分别定义为：1：流畅；2：清晰；3：高清；4：超清


cpName
string
true
所属cp, 没有所属CP的，用SPName代替


createDate
string
true
内容创建时间


verTimestamp
long
true
最后修改时间,时间戳 时间毫秒值


img
map
false
内容图片信息


groupImg
map
false
组图图片信息，仅对组图内容有效 useType: 1分辨率最小的，多分辨率依次递增


返回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",
                              "useType":"1" //使用方式  
                            },
                            {
                              "format": "640*320",
                              "url": "http://y2017.qn.cnliveimg.com/60/img/2017/0818/ff8080815def9dcb015df428048800e6/000006.jpg?imageView2/1/w/224/h/126",
                              "useType":"2"
                            }
                        ]
                        "desc": ""
                    }
                ]
                "rates": "2",
                "cpName": "测试账号",
                "subTitle": null,
                "tag": "黄家驹宣传片",
                "createDate": "2017-08-18",
                "verTimestamp": 1508320723191
            }
        ],
        "totalNum": 1,
        "nextCursor": 0,
        "previousCursor": 0
    }
}