MCBBS Wiki欢迎您共同参与编辑！在参与编辑之前请先阅读Wiki方针。
如果在编辑的过程中遇到了什么问题，可以去讨论板提问。
为了您能够无阻碍地参与编辑 未验证/绑定过邮箱的用户，请尽快绑定/验证。
MCBBS Wiki GitHub群组已上线！
您可以在回声洞中发表吐槽！
服务器状态监控。点击进入
本站由MCBBS用户自行搭建，与MCBBS及东银河系漫游指南（北京）科技有限公司没有从属关系。点此了解 MCBBS Wiki 不是什么>>
MCBBS Wiki:API：修订间差异
跳到导航
跳到搜索
小 （// Edit via Wikiplus） |
（→积分查询： // Edit via Wikiplus） |
||
| 第11行： | 第11行： | ||
</syntaxhighlight> |
</syntaxhighlight> |
||
==积分查询== |
==积分查询== |
||
<code style="background-color:#3bd671;color:#ffffff;border-color:#3bd671;">GET</code> {{code|/ |
<code style="background-color:#3bd671;color:#ffffff;border-color:#3bd671;">GET</code> {{code|/rest.php/mbwutils/v0/credit/3038}} |
||
===参数=== |
===参数=== |
||
{| class="wikitable" |
{| class="wikitable" |
||
| 第26行： | 第26行： | ||
<syntaxhighlight lang="JSON"> |
<syntaxhighlight lang="JSON"> |
||
{ |
{ |
||
"uid": 3038, |
"uid": 3038, |
||
"update": "2023-07-11 06:51:25", |
|||
| ⚫ | |||
"notfound": false, |
|||
| ⚫ | |||
"credits": { |
"credits": { |
||
" |
"credit": 48334, |
||
" |
"popularity": 11909, |
||
" |
"nugget": 12996, |
||
" |
"ingot": 0, |
||
" |
"gem": 11, |
||
" |
"star": 1, |
||
" |
"contribute": 191, |
||
" |
"heart": 0, |
||
" |
"diamond": 3447 |
||
}, |
}, |
||
" |
"activities": { |
||
"post": |
"post": 6801, |
||
"thread": |
"thread": 581, |
||
"digiest": 4, |
"digiest": 4, |
||
"currentGroupID": 28, |
|||
"userGroups": [ // 用户所拥有的用户组标签（机器可读） |
|||
"currentGroupText": "Lv.11 领主" |
|||
"admin", |
|||
"artist", |
|||
"super_moderator" |
|||
], |
|||
"userGroupsText": [ // 用户所拥有的用户组文字（人类可读） |
|||
"管理员", |
|||
"Lv.Inf 艺术家", |
|||
"超级版主" |
|||
], |
|||
"currentGroup": "admin", // 用户当前的用户组标签（机器可读） |
|||
"currentGroupText": "管理员" // 用户当前的用户组文字（人类可读） |
|||
} |
} |
||
} |
} |
||
| 第75行： | 第67行： | ||
| 无法从 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;color:#ffffff;border-color:#3bd671;">GET</code> {{code|/913-api/imgs/PID}} |
||
2023年7月11日 (二) 07:28的版本
本页记录了 MCBBS Wiki 上所有可调用的 API。
关于直接向 MediaWiki 请求数据的API，请参见[1]
错误信息格式
{
"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 | |
| size | string | 指定所返回图片的大小。
默认值：all |
响应
当 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 | 未找到图片。 |
| ||||||||||||||||||||||