Appearance
读取频道稿件列表
1 接口名称
读取频道稿件列表
2 接口描述
- 频道稿件列表(客户端展示的稿件列表)
3 请求地址
plain
{apiAddress}/openapi/v2/channel_article/channel_list?connectNo=cbd46dbf5e7af869&size=5&signature=8149956e94e904b9e0bddc3ec032f8b2&appkey=cblzs&sessionId=5bfdfd902096f011557830ca&channelId=639abec5e305b418fc469e3b&noncestr=1672901187751×tamp=1672901187751
4 请求方式
GET
5 请求参数
5.1 Query Params 参数
参数 | 类型 | 是否必须 | 字段说明 |
---|---|---|---|
connectNo | string | 是 | 约定的通信connectNo(区别用户) |
sessionId | string | 否 | 客户端用户sessionId |
channelId | string | 是 | 客户端频道ID |
start | long | 否 | 稿件sort_number值,可以为空 |
size | int | 是 | 获取稿件数量 |
6 返回参数
6.1参数描述
【channel】频道参数
字段 | 描述 | 说明 |
---|---|---|
id | 频道id | 频道id |
name | 名称 | |
code | ||
mlf_id | ||
focus_carousel | ||
focus_special | ||
category_id | ||
share_url |
【article_list】稿件参数
字段 | 描述 | 说明 |
---|---|---|
id | 稿件id | 稿件id |
mlf_id | 媒立方metadata id | |
list_title | 列表标题 | |
list_pics | 列表图片数组 | |
list_tag | 列表标签 | 独家、原创等 |
list_type | 列表展示类型 | 1-表示纯文本, 2-代表单图文类型, 3-代表多图(三张图)类型, 4-代表大图模式, 5-代表专栏, 6-代表多图(四张图)类型, 104-代表专题, 105-代表话题, 106-代表活动, 107-代表直播, 108-代表视频, 109-代表widget, 110-推荐位 , 111-视频专辑, 112-横幅 , 113-代表轮播图 |
doc_type | 稿件类型 | doc_type: 分别代表 1-未知 2-普通 3-链接、 4-图集、 5-专题、 6-话题、 7-活动、 8-直播、 9-视频 10- 视频专题 11-音频专辑 21-专栏/推荐位/轮播图 22-横幅 |
read_count | 阅读数 | |
read_count_general | 大概的阅读数,如1万+,如果read_count是0返回空字符串 | |
like_count | 点赞数 | |
comment_count | 评论数 | |
comment_count_general | 大概的评论数,如1万+,如果comment_count是0返回空字符串 | |
url | 新闻详情页url | |
share_url | 分享的新闻详情url | |
channel_id | 频道id | |
channel_name | 频道名称 | |
source_channel_id | 新闻来源频道id | 字符串可为空 |
channel_category_id | 频道所属分类 1为数采频道,2为地市频道,3为地方号频道,4.mcn频道 | (5.7) |
sort_number | 排序值 | 客户端在做分页时需要把最后一条的 sortnumber值传入作为分页参数 |
fixed_number | 固定位 | 大于0是固定位稿件,等于0是一般稿件 |
6.2参数示例
json
{
"code": 0,
"data": {
"channel": {
"id": "5c34198f83c7666577e98565",
"name": "宁波",
"code": "3",
"mlf_id": 1515,
"focus_carousel": false,
"focus_special": false,
"category_id": 2,
"share_url": "https://preapp.tmuyun.com/webChannels/normal?id=5c34198f83c7666577e98565&name=宁波&code=3&tenantId=6"
},
"focus_list": [],
"channel_banner": {},
"article_list": [
{
"id": 1410,
"mlf_id": 63846,
"list_title": "列表标题列表标题列表标题列表标题列表标题列表标题列表标题列表标题列表标题列表标题列表标题列表标题列表标题列表标题列表标题列表标题列表标题列表标题列表标题列表标题列表标题列表标题列表标题列表标题列表标题",
"list_pics": [
"https://preimg.tmuyun.com/assets/20221213/1670922440390_639840c86304405996d68b72.png"
],
"list_tag": "",
"list_type": 106,
"doc_type": 7,
"read_count": 155,
"read_count_general": "155",
"like_count": 0,
"comment_count": 0,
"comment_count_general": "",
"url": "https://preapp.tmuyun.com/webDetails/activity?id=1410&tenantId=6",
"share_url": "https://preapp.tmuyun.com/webDetails/activity?id=1410&tenantId=6",
"fixed_number": 0,
"display": "-1",
"original_id": 0,
"src_metadata_id": 0,
"like_enabled": true,
"comment_level": 1,
"channel_category_id": 2,
"channel_id": "5c34198f83c7666577e98565",
"channel_name": "宁波",
"channel_code": "3",
"parent_area_id": 623,
"source_channel_id": "",
"doc_title": "活动稿活动稿活动稿活动稿活动稿活动稿活动稿活动稿活动稿活动稿活动稿活动稿活动稿活动稿活动稿活动稿活动稿活动稿活动稿活动稿活动稿活动稿活动稿活动稿",
"author": "",
"summary": "",
"web_link": "",
"sort_number": 1546931155066,
"published_at": 1546931155000,
"created_at": 1546931149000,
"updated_at": 1670922440000,
"subject_display_like_enabled": false,
"activity_status": 2,
"activity_start": 1546790400000,
"activity_end": 1548691200000,
"activity_announced": false,
"related_article_ids": [],
"related_subject_ids": [],
"tenant_id": 6,
"read_count_config": 155,
"like_count_config": 0,
"read_count_addition": -1,
"fixed_read_count": -1,
"like_count_addition": -1,
"fixed_like_count": -1,
"status": 4,
"content_js_list": [
"https://pre-tool.tmuyun.com/style/public/front/js/zjrb-elements.js?t=11?t=1672110843025",
"https://preapp.tmuyun.com/client/js/iframes.js?t=1672110843025"
],
"mark_read": 0,
"custom_show_num": 2,
"custom_title_position": 0,
"custom_style": 0,
"img_width": "320",
"img_height": "180",
"type": 0,
"card_url": "https://preimg.tmuyun.com/assets/20221213/1670922443845_639840cb6304405996d68b79.png",
"cycle_carousel": false,
"audio_url": "",
"show_type": 0
}
],
"app_nav": [],
"has_more": false
}
}
7 备注
成功返回code是0,非0时均为失败。