首页帖子接口-用于展示首页帖子
GET /posts
Head
参数 |
类型 |
是否必须 |
说明 |
Access-Token |
字符型 |
可选 |
用户token |
Parameters
参数 |
类型 |
是否必须 |
默认值 |
范围 |
说明 |
offset |
整型 |
可选 |
0 |
正整数 |
当前起始数 |
limit |
整型 |
可选 |
20 |
正整数 |
每页数量 |
latest |
布尔型 |
可选 |
TRUE |
|
TRUE为最新话题,FALSE为我的星球 |
Response
参数 |
类型 |
说明 |
id |
int |
帖子ID |
title |
string |
标题 |
content |
string |
内容 |
create_time |
date |
发帖时间 |
approved |
bool |
是否点赞(TRUE已点赞) |
approved_num |
int |
点赞数 |
collected |
bool |
是否收藏(TRUE已收藏) |
collected_num |
int |
收藏数 |
replied |
bool |
是否回复(TRUE已回复) |
replied_num |
int |
回复数 |
image_url |
array |
帖子图片预览3张url地址 |
author.name |
string |
发帖人 |
author.avatar_url |
string |
用户头像图片url |
author.id |
int |
发帖者id |
group.id |
int |
星球ID |
group.name |
string |
星球名称 |
200
{
"data": [
{
"id": "42",
"title": "1",
"content": "1",
"create_time": "2017-07-20T12:50:30.176Z",
"approved": TRUE,
"approved_num": "3",
"collected": TRUE,
"collected_num": "0",
"replied": TRUE,
"replied_num": "0",
"image_url": []
"author": {
"avatar_url": "http://7xlx4u.com1.z0.glb.clouddn.com/o_1aqt96pink2kvkhj13111r15tr7.jpg?imageView2/1/w/100/h/100",
"name": "汪汪汪",
"id": "2"
},
"group": {
"id": "1",
"name": "装备2014中队"
}
},
...
],
"paging": {
first: "http://api.com/post?offset=0&limit=5",
previous: "http://api.com/post?offset=5&limit=5",
next: "http://api.com/post?offset=10&limit=5",
final: "http://api.com/post?offset=35&limit=5"
}
}
204 帖子列表为空
400
{
"error": "获取帖子列表失败"
}