接口简介
- 本接口主要用于请求app首页多栏目中类型为信息流的数据
- 本接口同时支持page分页和游标分页
接口请求说明
请求方式
GET https://站点接口域名/openapi/feeds
请求参数
参数名 | 类型 | 是否必须 | 说明 |
---|---|---|---|
tab_id | int | ✅ | 栏目id,默认为推荐信息流 |
cursor | int | ✅ | 游标分页,时间戳 |
page | int | 分页,如果用获取固定位,请传此参数,从1开始 |
如何使用游标分页:
- 第一页直接使用cursor=time()当前时间戳,将会获得按照时间倒序排列的10条信息流
- 然后获取这10条信息流中最后一条信息流的push_at字段值作为第二页的cursor即可
请求示例
# GET请求
curl -X GET 'https://站点接口域名/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三种细分类型,很老的信息流还是有可能会返回该种类型
文档更新时间: 2022-11-28 17:14 作者:千帆云