获取帖子列表 - BIT101-API

根据mode选择不同的模式

recommend：推荐模式，此时忽略search、order和uid，返回public=true，anonymous任意的帖子。
search：搜索模式，此时需要考虑search、order和uid。当uid<0返回public=true，anonymous任意的帖子；当uid=0时，全部返回；当uid>0时，仅返回public=true且anonymous=false的帖子。
follow：关注模式，此时忽略search、order和uid，返回public=true，anonymous=false，按时间倒序的帖子。
hot：热榜模式，此时忽略search、order和uid，返回public=true，anonymous任意的帖子。
hide_bot: 是否隐藏机器人，仅在search模式有效

请求参数

Query 参数

mode

string

可选

模式 recommend | search | follow | hot 默认为recommend

示例值:

page

integer

可选

页码从0开始默认为0

string

搜索参数默认为空

可选

order

integer

可选

排序方式 comment | like | new 默认为new

uid

integer

可选

特定用户 -1为不筛选 0时为自己返回非public的默认为-1

示例值:

-1

hide_bot

integer

可选

隐藏机器人 0为不隐藏其他隐藏默认为0

示例值:

Header 参数

fake-cookie

string

可选

示例值:

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

array of:

integer

必需

title

string

标题

必需

text

string

内容

必需

images

array[object (图片) {3}]

图片

必需

图片链接列表

>= 0 items<= 24 items

mid

string

图片唯一编码

必需

url

string

原图链接

必需

low_url

string

低分辨率图片链接

必需

like_num

integer

点赞数量

必需

comment_num

integer

评论数量

必需

create_time

string

发布时间

必需

edit_time

string

编辑时间

必需

update_time

string

更新时间

必需

有新点赞评论等也算更新

user

object (用户)

发布用户

必需

integer

必需

create_time

string

注册时间

必需

nickname

string

昵称

必需

avatar

object (图片)

头像链接

必需

motto

string

格言/简介

必需

identity

object

身份

必需

anonymous

boolean

匿名

必需

发送者是否匿名

tags

array[string]

标签

必需

claim

object (声明)

声明

必需

如政治相关等

integer

必需

text

string

声明内容

必需

public

boolean

公开

必需

公开或仅自己可见

示例

[
  {
    "id": 0,
    "title": "string",
    "text": "string",
    "images": [
      {
        "mid": "string",
        "url": "string",
        "low_url": "string"
      }
    ],
    "like_num": 0,
    "comment_num": 0,
    "create_time": "string",
    "edit_time": "string",
    "update_time": "string",
    "user": {
      "id": 0,
      "create_time": "string",
      "nickname": "string",
      "avatar": {
        "mid": "string",
        "url": "string",
        "low_url": "string"
      },
      "motto": "string",
      "identity": {
        "id": 0,
        "color": "string",
        "text": "string"
      }
    },
    "anonymous": true,
    "tags": [
      "string"
    ],
    "claim": {
      "id": 0,
      "text": "string"
    },
    "public": true
  }
]

🟠404记录不存在

🟠400参数不正确

🔴500服务器错误

🟠401身份验证失败