MCBBS Wiki:API

Litwak913留言 | 贡献2023年7月11日 (二) 07:28的版本 →‎积分查询:​ // Edit via Wikiplus

本页记录了 MCBBS Wiki 上所有可调用的 API。

关于直接向 MediaWiki 请求数据的API,请参见[1]

GitHub 仓库

错误信息格式

{
    "message":"错误的详细信息"
}

积分查询

GET /rest.php/mbwutils/v0/credit/3038

参数

路径参数
参数名 类型 描述 必须
UID number 要查询用户的 UID。

响应

以 UID 3038(混乱)为例。

{
  "uid": 3038,
  "update": "2023-07-11 06:51:25",
  "notfound": false,
  "nickname": "混乱",
  "credits": {
    "credit": 48334,
    "popularity": 11909,
    "nugget": 12996,
    "ingot": 0,
    "gem": 11,
    "star": 1,
    "contribute": 191,
    "heart": 0,
    "diamond": 3447
  },
  "activities": {
    "post": 6801,
    "thread": 581,
    "digiest": 4,
    "currentGroupID": 28,
    "currentGroupText": "Lv.11 领主"
  }
}

响应状态代码

状态 描述
200 OK
400 请求参数错误。
404 未找到用户或无法访问用户页面。
500 无法从 MCBBS 获取积分信息。

论坛梗图

GET /913-api/imgs/PID

参数

路径参数
参数名 类型 描述 必须
PID number 要查询图片的 PID,未指定则随机抽取。
查询参数
参数名 类型 描述 必须
type string 指定所返回信息的类型。

默认值:img
可以是以下其中之一:img,json

size string 指定所返回图片的大小。

默认值:all
可以是以下其中之一:all,small,normal
all:返回所有大小图片
small:返回宽度较窄的图片
normal:返回正常大小图片

响应

当 type 为 img 时,将会重定向至图片的 URL,所有图片均为 webp 格式。

当 type 为 json 时,将返回以下 JSON 数据。

{
  "id": 3, // 图片 PID
  "path": "/images/memes/3.webp", // 图片的相对 URL
  "page": "挖掘卡", // 图片对应的 Wiki 页面
  "small": 0 // 图片的大小,0 为正常大小,1 为宽度较窄
}

响应状态代码

状态 描述
200 OK(仅当 type 为 json 时)
302 重定向至图片的 URL。
400 请求参数错误。
404 未找到图片。