三、新闻列表

3.1请求地址

环境 方法 请求地址
线上 get http://api.adphoenixs.com/api/v1/raw/list

3.2请求参数

名称 类型 是否必填 示例 描述
appKey String 应用的唯一标识,应用的唯一标识,可在后台管理里获取
timestamp long Unix时间戳,精确到毫秒,与系统时间误差最大在5分钟
channelTag String 频道tag
version String v1.0.0 版本号,本版本为v1.0.0
platform int 1 用户平台,1:Android,2:iOS,3:H5
attachPlatform int H5所嵌平台,1:Android,2:iOS,如果platform为3,则本参数必传
deviceId String 设备ID,移动设备的唯一标示,比如iOS系统的IDFA、IDFV,安卓系统的IMEI,mac地址等(建议使用有料官方设备id生成方案,可以大幅提高推荐效果),详见"设备id(deviceId)获取规则",deviceId和cookie两者必传其中之一,deviceId优先。
cookie String cookie,以H5接入或者临时测试时使用,deviceId获取不到时也可以使用此值,生成规则可以使用uuid方式,但uuid不要做任何处理,包括去掉“-”等
num int 15 新闻条数,单次请求上限为20条
group int 新闻列表组合类型。0:客户端上滑,返回普通新闻;1:客户端下拉且不是首次进入应用,返回头图新闻,置顶新闻和普通新闻;2:表示应用退出后,重新打开应用,某个频道首次下拉刷新时,返回头图新闻,置顶新闻和普通新闻

3.3返回值

JsonObject,参数data如下:

名称 类型 是否必填 示例 描述
infos JsonArray 普通新闻,格式根据infoType不同也会不同,详见下文
banners JsonArray 轮播图,格式同infos,group=1或2时有值,每次调用会返回最新结果
tops JsonArray 置顶新闻,格式同infos,group=1或2时有值,每次调用会返回最新结果
bannerType int 轮播图的展示形式,0:自动轮播图和轮播图置顶均关闭,1:自动轮播图,2:轮播图置顶
channelType int 频道类型,4:自营频道,非4:非自营频道,注意:客户端如果发现频道类型与缓存的频道类型不一致,需要清除频道缓存,重新拉取频道信息,此外,自营频道在后台在下发新闻时不去重,非自营频道会去重,客户端的新闻缓存策略也需要做相应调整

3.3.1 infoType为artcile时,表示文章

infos,banners,tops参数具体如下:

名称 类型 是否必填 示例 描述
h5Url String 新闻的h5链接
producer String user 新闻生产者,user:用户,recommendation:推荐系统
recId String 推荐唯一标识,上报用户行为是需要携带
algInfo String 推荐策略及权重信息,上传用户行为时需携带,producer为recommendation时才有值
infoId String 新闻id
infoType String article 新闻类型,article:文章,picset:图集,video:视频
title String 新闻标题
summary String 新闻简介
source String 新闻来源
publishTime String 新闻发布时间,格式yyyy-MM-dd HH:mm:ss
imgType int 封面缩略图模式,0:无图,1:单图,2:大图,3:三图
thumbnails JsonArray 封面缩略图
└url String 缩略图url
└height int 缩略图高度,字段未出现或者为0表示未知
└width int 缩略图宽度,字段未出现或者为0表示未知
deliverId long 新闻的投递id
feedbacks JsonArray 用户可选择的负反馈内容,最多7项,最少3项
└name String 客户端展示内容
└value String 客户端上报内容
channelTag String 频道tag

3.3.2 infoType为picset时,表示图集

infos,banners,tops参数具体如下:

名称 类型 是否必填 示例 描述
h5Url String 新闻的h5链接
producer String user 新闻生产者,user:用户,recommendation:推荐系统
recId String 推荐唯一标识,上报用户行为是需要携带
algInfo String 推荐策略及权重信息,上传用户行为时需携带,producer为recommendation时才有值
infoId String 新闻id
infoType String article 新闻类型,article:文章,picset:图集,video:视频
title String 新闻标题
summary String 新闻简介
source String 新闻来源
publishTime String 新闻发布时间,格式yyyy-MM-dd HH:mm:ss
imgType int 封面缩略图模式,0:无图,1:单图,2:大图,3:三图
thumbnails JsonArray 封面缩略图
└url String 缩略图url
└height int 缩略图高度,字段未出现或者为0表示未知
└width int 缩略图宽度,字段未出现或者为0表示未知
deliverId long 新闻的投递id
feedbacks JsonArray 用户可选择的负反馈内容,最多7项,最少3项
└name String 客户端展示内容
└value String 客户端上报内容
channelTag String 频道tag
num int 图集图片的个数

3.3.3 infoType为video时,表示视频

infos,banners,tops参数具体如下:

名称 类型 是否必填 示例 描述
h5Url String 新闻的h5链接
producer String user 新闻生产者,user:用户,recommendation:推荐系统
recId String 推荐唯一标识,上报用户行为是需要携带
algInfo String 推荐策略及权重信息,上传用户行为时需携带,producer为recommendation时才有值
infoId String 新闻id
infoType String article 新闻类型,article:文章,picset:图集,video:视频
title String 新闻标题
summary String 新闻简介
source String 新闻来源
publishTime String 新闻发布时间,格式yyyy-MM-dd HH:mm:ss
imgType int 封面缩略图模式,0:无图,1:单图,2:大图,3:三图
thumbnails JsonArray 封面缩略图
└url String 缩略图url
└height int 缩略图高度,字段未出现或者为0表示未知
└width int 缩略图宽度,字段未出现或者为0表示未知
deliverId long 新闻的投递id
feedbacks JsonArray 用户可选择的负反馈内容,最多7项,最少3项
└name String 客户端展示内容
└value String 客户端上报内容
channelTag String 频道tag
duration int 视频时长(单位:秒)

3.4注意

h5Url 为渠道的新闻详情链接,api接入时,列表新闻点击后跳转到该url。

3.5示例

request

http://api.adphoenixs.com/api/v1/raw/list?appKey=a9bfcbd77aed59d33d77710050ce42d6&timestamp=1541645582000&channelTag=79dffb1c51084da494f92f23c5fff5fc&platform=1&deviceId=1223333333

response

{
    "requestId": "f047e8f7c1c746449ba442e57ee1055c",
    "code": 0,
    "message": "success",
    "data": {
        "banners": [],
        "tops": [],
        "infos": [
            {
                "producer": "recommendation",
                "recId": "0100b42777a042bf8ebcf9d957c6fc34_f",
                "algInfo": "|HOT_MS|g_b-7",
                "infoId": "IN2W3TJC3QOC1NW",
                "infoType": "article",
                "title": "明星立冬保暖 王俊凯吃烤红薯 关晓彤戴兔子帽 陈赫送雪地靴",
                "summary": "立冬了,南方感觉还是秋高气爽,阳光还是暖暖的紫外红还是很猛,而北方或方真是变冷了,明星们在立冬这一天纷纷分享自己如何保暖的,让大家记得穿多件衣服不要受冷了。",
                "source": "小步娱乐君",
                "category": "娱乐-明星八卦",
                "sourceLink": null,
                "imgType": 3,
                "thumbnails": [
                    {
                        "width": 300,
                        "height": 200,
                        "url": "http://recn.nosdn.127.net/icovr-20181108-fc5b606135b4c13bb565f000fbf9eff7.jpg",
                        "note": null
                    },
                    {
                        "width": 300,
                        "height": 200,
                        "url": "http://recn.nosdn.127.net/icovr-20181108-f676f022540eda53074286460a86d807.jpg",
                        "note": null
                    },
                    {
                        "width": 300,
                        "height": 200,
                        "url": "http://recn.nosdn.127.net/icovr-20181108-b26061b5fd735b6552dba0cb84c7af95.jpg",
                        "note": null
                    }
                ],
                "largeImgs": null,
                "deliverId": null,
                "publishTime": "2018-11-08 21:47:53",
                "originalPublishTime": "2018-11-08 06:28:50",
                "feedbacks": [
                    {
                        "name": "不感兴趣",
                        "value": "D_0"
                    },
                    {
                        "name": "内容质量差",
                        "value": "D_1"
                    },
                    {
                        "name": "看过了",
                        "value": "D_2"
                    },
                    {
                        "name": "不想看:小步娱乐君",
                        "value": "S_小步娱乐君"
                    },
                    {
                        "name": "不想看:明星八卦",
                        "value": "C_34"
                    },
                    {
                        "name": "不想看:王俊凯",
                        "value": "P_C娱乐_I王俊凯"
                    },
                    {
                        "name": "不想看:陈赫",
                        "value": "P_C娱乐_I陈赫"
                    }
                ],
                "channelTag": "79dffb1c51084da494f92f23c5fff5fc",
                "mark": "热门",
                "h5Url": "http://test.kaixinlrs.com/article.html?recId=0100b42777a042bf8ebcf9d957c6fc34_f&producer=recommendation&infoId=IN2W3TJC3QOC1NW"
            },
            {
                "producer": "recommendation",
                "recId": "0100b42777a042bf8ebcf9d957c6fc34_f",
                "algInfo": "|EXP_USER_UCB|cat-205",
                "infoId": "VN2W3RTEITEB4ZP",
                "infoType": "video",
                "title": "这首黄霑只用20分钟填词, 当年手机铃声必备的一首歌",
                "summary": null,
                "source": "华语音乐",
                "category": "音乐",
                "sourceLink": null,
                "imgType": 1,
                "thumbnails": [
                    {
                        "width": 300,
                        "height": 200,
                        "url": "http://recn.nosdn.127.net/icovr-20181107-cffb8d1f70169b68427f2fac9fdcf66c.jpg",
                        "note": null
                    }
                ],
                "largeImgs": [
                    {
                        "width": 768,
                        "height": 384,
                        "url": "http://recn.nosdn.127.net/icovr-20181107-71124d7d9b296fc9c3efa435b9563971.jpg",
                        "note": null
                    }
                ],
                "deliverId": null,
                "publishTime": "2018-11-08 21:35:53",
                "originalPublishTime": "2018-11-07 21:59:43",
                "feedbacks": [
                    {
                        "name": "不感兴趣",
                        "value": "D_0"
                    },
                    {
                        "name": "内容质量差",
                        "value": "D_1"
                    },
                    {
                        "name": "看过了",
                        "value": "D_2"
                    },
                    {
                        "name": "不想看:华语音乐",
                        "value": "S_华语音乐"
                    },
                    {
                        "name": "不想看:音乐",
                        "value": "C_205"
                    },
                    {
                        "name": "不想看:手机铃声",
                        "value": "P_C音乐_I手机铃声"
                    },
                    {
                        "name": "不想看:黄霑",
                        "value": "P_C音乐_I黄霑"
                    }
                ],
                "channelTag": "79dffb1c51084da494f92f23c5fff5fc",
                "mark": null,
                "duration": 239,
                "cover": "http://recn.nosdn.127.net/irec-20181108-822b11ae3353a329552f4aba1c61a944.jpg",
                "largeCover": "http://vimg.nosdn.127.net/snapshot/20181107/sXdPT127Yw6kXh_cover.jpg",
                "mp4SdUrl": "https://union-online.nosdn.127.net/icvtd-20181108-5f9dc10033fddc00a576c1be9d6265a0.mp4",
                "mp4HdUrl": null,
                "h5Url": "http://test.kaixinlrs.com/article.html?recId=0100b42777a042bf8ebcf9d957c6fc34_f&producer=recommendation&infoId=VN2W3RTEITEB4ZP"
            }
        ],
        "bannerType": 0,
        "channelType": 0
    }
}

results matching ""

    No results matching ""