接口简介

  • 本接口主要用于请求app首页多栏目中类型为信息流的数据
  • 本接口同时支持page分页和游标分页

接口请求说明

请求方式

GET https://hostname.qianfanapi.com/openapi/feeds

请求参数

参数名 类型 是否必须 说明
tab_id int 栏目id,默认为推荐信息流
cursor int 游标分页,时间戳
page int 普通分页
per-page int 每页返回数据条数,默认为10,配合page或cursor使用

如何使用游标分页:(假设per-page不传默认为10)

  • 第一页直接使用cursor=time()当前时间戳,将会获得按照时间倒序排列的10条信息流
  • 然后获取这10条信息流中最后一条信息流的push_at字段值作为第二页的cursor即可

当使用page进行分页时,我们还会在响应头中返回额外的分页基础数据:

  • X-Pagination-Current-Page 指示当前返回的是第几页的数据
  • X-Pagination-Per-Page 指示每页数据的条数
  • X-Pagination-Page-Count 指示总页数
  • X-Pagination-Total-Count 指示信息流总条数

page和corsor至少需要设置一种分页方式,当两者同时设置时将优先使用corsor游标分页

请求示例

# GET请求
curl -X GET  'https://{hostname}.qianfanapi.com/openapi/feeds?tab_id=1&page=2&per-page=12' \
  -H 'Authorization: Bearer 5d39164d1f281' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json'

接口响应说明

响应示例

{
    "code": 0,
    "text": "",
    "data": [
        {
            "id": 1974,
            "to_type": 9,
            "to_id": 8,
            "title": "1",
            "desc": "",
            "show_mode": 1,
            "attaches": null,
            "attaches_num": 0,
            "views_num": 0,
            "replies_num": 0,
            "likes_num": 0,
            "rewards_num": 0,
            "author_id": 0,
            "author": "",
            "fixed_position": 0,
            "fixed_start_at": 0,
            "fixed_expire_at": 0,
            "push_at": 1545117613,
            "created_at": 0
        },
        {
            "id": 1895,
            "to_type": 13,
            "to_id": 3255,
            "title": "哦哦哦哦哦哦",
            "desc": "",
            "show_mode": 1,
            "attaches": [
                {
                    "url": "http://bbs1.qianfanyun.com/meipai/day_141101/1669595_d25a69ab-ed32-4186-a09f-4c64ad390796.s.576x768.jpg",
                    "width": "0",
                    "height": "0",
                    "origin_url": "http://bbs1.qianfanyun.com/meipai/day_141101/1669595_d25a69ab-ed32-4186-a09f-4c64ad390796.jpg",
                    "is_show": 1
                }
            ],
            "attaches_num": 1,
            "views_num": 6470,
            "replies_num": 0,
            "likes_num": 0,
            "rewards_num": 0,
            "author_id": 3,
            "author": "qianfan1",
            "fixed_position": 0,
            "fixed_start_at": 0,
            "fixed_expire_at": 0,
            "push_at": 1538186050,
            "created_at": 1522055387
        },
        {
            "id": 1999,
            "to_type": 1,
            "to_id": 14293858,
            "title": "2018最新房产税征收标准!有多套房的你不来了解一下吗?",
            "desc": "",
            "show_mode": 4,
            "attaches": [
                {
                    "url": "http://pic.hualongxiang.com/attachment/Day_180809/202_2149578_c96639d8e367bea.jpg?x-oss-process=image/resize,m_fill,w_452,h_348",
                    "width": 452,
                    "height": 348,
                    "is_show": 1,
                    "origin_url": "http://pic.hualongxiang.com/attachment/Day_180809/202_2149578_c96639d8e367bea.jpg"
                },
                {
                    "url": "http://pic.hualongxiang.com/attachment/Day_180809/202_2149578_d6c3411f850e4c5.jpg?x-oss-process=image/resize,m_fill,w_452,h_348",
                    "width": 452,
                    "height": 348,
                    "is_show": 1,
                    "origin_url": "http://pic.hualongxiang.com/attachment/Day_180809/202_2149578_d6c3411f850e4c5.jpg"
                },
                {
                    "url": "http://pic.hualongxiang.com/attachment/Day_180809/202_1308755_a758380431f6890.jpg?x-oss-process=image/resize,m_fill,w_452,h_348",
                    "width": 452,
                    "height": 348,
                    "is_show": 1,
                    "origin_url": "http://pic.hualongxiang.com/attachment/Day_180809/202_1308755_a758380431f6890.jpg"
                }
            ],
            "attaches_num": 3,
            "views_num": 571,
            "replies_num": 3,
            "likes_num": 0,
            "rewards_num": 0,
            "author_id": 2149578,
            "author": "孤影碧雪",
            "fixed_position": 0,
            "fixed_start_at": 0,
            "fixed_expire_at": 0,
            "push_at": 1533808706,
            "created_at": 1533805360
        }
    ],
    "time": 1565685195
}

响应结果说明

字段名 类型 说明
id int 信息流id
to_type int 跳转类型
to_id string 跳转id,如帖子id/圈子id或者h5的链接地址等
title string 标题
desc string 描述
show_mode int 展示模式
attahces array 附件数组
attaches_num int 附件数量
views_num int 浏览量
replies_num int 回复数
likes_num int 点赞数
rewards_num int 打赏数
author_id int 作者id
fixed_position int 固定位 默认为0不固定
fixed_start_at int 固定位开始时间(固定位不为0时才有效)
fixed_expire_at int 固定位结束时间(固定位不为0时才有效)
push_at int 推送时间(刷新可以令推送时间更新)
created_at int 创建时间(首次进入信息流的时间,进入信息流后不再变化)

附件表字段说明

字段名 类型 说明
url string 缩略图地址
origin_url string 原图地址
width int 图片宽(缩略图)
height int 图片高(缩略图)
is_show int 是否显示

本接口会返回后台设置的所有附件,但是千帆app和wap只会显示is_show=1的附件

to_type类型

字段名 说明
1 帖子
2 话题
3 外链
5 本地圈
9 专题
11 本地圈 纯文本
12 本地圈 带图片
13 本地圈 小视频
14 分类信息

其中to_type=5本地圈已拆分成11,12,13三种细分类型,很老的信息流还是有可能会返回该种类型

文档更新时间: 2019-08-13 16:50   作者:千帆云