MCBBS Wiki:API

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

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

GitHub 仓库

错误信息格式

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

积分查询

GET /913-api/users/UID

参数

路径参数

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

响应

以 UID 3038（混乱）为例。

{
  "uid": 3038, // 用户 UID
  "nickname": "混乱", // 用户名
  "credits": {
    "nugget": 10648, // 金粒数
    "gem": 11, // 宝石数
    "heart": 0, // 爱心数
    "contribute": 165, // 贡献数
    "diamond": 3447, // 钻石数
    "popularity": 11454, // 人气数
    "ingot": 0, // 金锭数
    "star": 1, // 下界之星数
    "credit": 46696, // 积分总数
  },
  "activites": {
    "post": 6791, // 回帖数
    "thread": 577, // 主题数
    "digiest": 4, // 精华数
    "userGroups": [ // 用户所拥有的用户组标签（机器可读）
      "admin",
      "artist",
      "super_moderator"
    ],
    "userGroupsText": [ // 用户所拥有的用户组文字（人类可读）
      "管理员",
      "Lv.Inf 艺术家",
      "超级版主"
    ],
    "currentGroup": "admin", // 用户当前的用户组标签（机器可读）
    "currentGroupText": "管理员" // 用户当前的用户组文字（人类可读）
  }
}

响应状态代码

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

用户组文字和用户组标签对应关系

用户组文字	用户组标签
管理员	admin
管理员助理	admin_helper
村民	village
版主	moderator
实习版主	pre_moderator
大区版主	region_moderator
问答区版主	qa_moderator
超级版主	super_moderator
专区版主	prefecture_moderator
荣誉版主	honor_moderator
Lv.Inf 艺术家	artist
电鳗	afdian
认证用户	verify
哔	bi
Lv.12 屠龙者	12
Lv.11 领主	11
Lv.10 附魔师	10
Lv.9 牧场主	9
Lv.8 考古家	8
Lv.7 猎手	7
Lv.6 手艺人	6
Lv.5 农夫	5
Lv.4 矿工	4
Lv.3 挖沙工	3
Lv.2 采石匠	2
Lv.1 伐木工	1
Lv.0 流浪者	0
Lv-? 禁止发言	banpost
Lv-? 禁止访问	banid
Lv.? Herobrine	herobrine
Lv-? 禁止 IP	banip
等待验证会员	wait_verify

论坛梗图

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	未找到图片。