MCBBS Wiki欢迎您共同参与编辑！在参与编辑之前请先阅读Wiki方针。

如果在编辑的过程中遇到了什么问题，可以去讨论板提问。

为了您能够无阻碍地参与编辑 未验证/绑定过邮箱的用户，请尽快绑定/验证。

MCBBS Wiki GitHub群组已上线！

您可以在回声洞中发表吐槽！

服务器状态监控。点击进入

本站由MCBBS用户自行搭建，与MCBBS及东银河系漫游指南（北京）科技有限公司没有从属关系。点此了解 MCBBS Wiki 不是什么>>

MCBBS Wiki:API：修订间差异

来自MCBBS Wiki
跳到导航 跳到搜索
可视化wikitext
标签：移动版编辑 移动版网页编辑 高级移动版编辑
（→‎响应：​ // Edit via Wikiplus）
 
（未显示同一用户的8个中间版本）
第2行： 第2行：


关于直接向 MediaWiki 请求数据的API，请参见[https://mcbbs.wiki/api.php]
关于直接向 MediaWiki 请求数据的API，请参见[https://mcbbs.wiki/api.php]

==错误信息格式==
[https://github.com/mcbbs-wiki/wiki-api GitHub 仓库]
<syntaxhighlight lang="JSON">
{
"message":"错误的详细信息"
}
</syntaxhighlight>
==积分查询==
==积分查询==
<code style="background-color:#3bd671;color:#ffffff;border-color:#3bd671;">GET</code> {{code|/913-api/users/UID}}
<code style="background-color:#3bd671 !important;color:#ffffff;border-color:#3bd671;">GET</code> {{code|/rest.php/mbwutils/v0/credit/UID}}
===参数===
===参数===
{| class="wikitable"
{| class="wikitable"
第24行： 第20行：
<syntaxhighlight lang="JSON">
<syntaxhighlight lang="JSON">
{
{
"uid": 3038, // 用户 UID
"uid": 3038,
"update": "2023-07-11 06:51:25",
"nickname": "混乱", // 用户名
"notfound": false,
"nickname": "混乱",
"credits": {
"credits": {
"nugget": 10648, // 金粒数
"credit": 48334,
"gem": 11, // 宝石数
"popularity": 11909,
"heart": 0, // 爱心数
"nugget": 12996,
"contribute": 165, // 贡献数
"ingot": 0,
"diamond": 3447, // 钻石数
"gem": 11,
"popularity": 11454, // 人气数
"star": 1,
"ingot": 0, // 金锭数
"contribute": 191,
"star": 1, // 下界之星数
"heart": 0,
"credit": 46696, // 积分总数
"diamond": 3447
},
},
"activites": {
"activities": {
"post": 6791, // 回帖数
"post": 6801,
"thread": 577, // 主题数
"thread": 581,
"digiest": 4, // 精华数
"digiest": 4,
"currentGroupID": 28,
"userGroups": [ // 用户所拥有的用户组标签（机器可读）
"currentGroupText": "Lv.11 领主"
"admin",
"artist",
"super_moderator"
],
"userGroupsText": [ // 用户所拥有的用户组文字（人类可读）
"管理员",
"Lv.Inf 艺术家",
"超级版主"
],
"currentGroup": "admin", // 用户当前的用户组标签（机器可读）
"currentGroupText": "管理员" // 用户当前的用户组文字（人类可读）
}
}
}
}
第73行： 第61行：
| 无法从 MCBBS 获取积分信息。
| 无法从 MCBBS 获取积分信息。
|}
|}
=== 用户组文字和用户组标签对应关系 ===
{| class="wikitable mw-collapsible mw-collapsed"
! 用户组文字 !! 用户组标签
|-
| [[ 管理员 ]] || 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
|-
| [[ Herobrine|Lv.? Herobrine ]] || herobrine
|-
| [[ 禁止IP|Lv-? 禁止 IP ]] || banip
|-
| [[ 等待验证会员 ]] || wait_verify


|}
==论坛梗图==
==论坛梗图==
<code style="background-color:#3bd671;color:#ffffff;border-color:#3bd671;">GET</code> {{code|/913-api/imgs/PID}}
<code style="background-color:#3bd671 !important;color:#ffffff;border-color:#3bd671;">GET</code> {{code|/bbs-img/PID}}
===参数===
===参数===
{| class="wikitable"
{| class="wikitable"
第156行： 第76行：
| number
| number
| 要查询图片的 PID，未指定则随机抽取。
| 要查询图片的 PID，未指定则随机抽取。
|}
{| class="wikitable"
|+ 查询参数
|-
! 参数名
! 类型
! 描述
! 必须
|-
| type
| string
| 指定所返回信息的类型。
默认值：img<br>
可以是以下其中之一：img,json
|-
| size
| string
| 指定所返回图片的大小。
默认值：all<br>
可以是以下其中之一：all,small,normal<br>
all:返回所有大小图片<br>
small:返回宽度较窄的图片<br>
normal:返回正常大小图片
|}
|}
===响应===
===响应===
当 type 为 img 时，将会重定向至图片的 URL，所有图片均为 webp 格式。
重定向至图片的 URL，所有图片均为 webp 格式。

当 type 为 json 时，将返回以下 JSON 数据。
<syntaxhighlight lang="JSON">
{
"id": 3, // 图片 PID
"path": "/images/memes/3.webp", // 图片的相对 URL
"page": "挖掘卡", // 图片对应的 Wiki 页面
"small": 0 // 图片的大小，0 为正常大小，1 为宽度较窄
}
</syntaxhighlight>


===响应状态代码===
===响应状态代码===
第197行： 第84行：
! 状态
! 状态
! 描述
! 描述
|-
| 200
| OK（仅当 type 为 json 时）
|-
|-
| 302
| 302

2024年2月25日 (日) 10:05的最新版本

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

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

GitHub 仓库

积分查询

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

参数

路径参数
参数名 类型 描述 必须
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 /bbs-img/PID

参数

路径参数
参数名 类型 描述 必须
PID number 要查询图片的 PID，未指定则随机抽取。

响应

重定向至图片的 URL，所有图片均为 webp 格式。

响应状态代码

状态 描述
302 重定向至图片的 URL。
400 请求参数错误。
404 未找到图片。
MCBBS Wiki导航
规章制度
讨论与申请
编辑与维护
帮助与指引
取自“https://mcbbs.wiki/index.php?title=MCBBS_Wiki:API&oldid=53837”