Skip to content

读取频道稿件列表

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&timestamp=1672901187751

4 请求方式

GET

5 请求参数

5.1 Query Params 参数

参数类型是否必须字段说明
connectNostring约定的通信connectNo(区别用户)
sessionIdstring客户端用户sessionId
channelIdstring客户端频道ID
startlong稿件sort_number值,可以为空
sizeint获取稿件数量

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时均为失败。