|
关于直接向 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 !important;color:#ffffff;border-color:#3bd671;">GET</code> {{code|/913-apirest.php/mbwutils/v0/userscredit/UID}}
===参数===
{| class="wikitable"
<syntaxhighlight lang="JSON">
{
"uid": 3038, // 用户 UID
"update": "2023-07-11 06:51:25",
"nickname": "混乱", // 用户名
"notfound": false,
"nickname": "混乱",
"credits": {
"nuggetcredit": 1064848334, // 金粒数
"gempopularity": 1111909, // 宝石数
"heartnugget": 012996, // 爱心数
"contributeingot": 1650, // 贡献数
"diamondgem": 344711, // 钻石数
"popularitystar": 114541, // 人气数
"ingotcontribute": 0191, // 金锭数
"starheart": 10, // 下界之星数
"creditdiamond": 46696, // 积分总数3447
},
"activitesactivities": {
"post": 67916801, // 回帖数
"thread": 577581, // 主题数
"digiest": 4, // 精华数
"currentGroupID": 28,
"userGroups": [ // 用户所拥有的用户组标签（机器可读）
"currentGroupText": "Lv.11 领主"
"admin",
"artist",
"super_moderator"
],
"userGroupsText": [ // 用户所拥有的用户组文字（人类可读）
"管理员",
"Lv.Inf 艺术家",
"超级版主"
],
"currentGroup": "admin", // 用户当前的用户组标签（机器可读）
"currentGroupText": "管理员" // 用户当前的用户组文字（人类可读）
}
}
| 无法从 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 !important;color:#ffffff;border-color:#3bd671;">GET</code> {{code|/913bbs-api/imgsimg/PID}}
===参数===
{| class="wikitable"
| number
| 要查询图片的 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 格式。
当 type 为 json 时，将返回以下 JSON 数据。
<syntaxhighlight lang="JSON">
{
"id": 3, // 图片 PID
"path": "/images/memes/3.webp", // 图片的相对 URL
"page": "挖掘卡", // 图片对应的 Wiki 页面
"small": 0 // 图片的大小，0 为正常大小，1 为宽度较窄
}
</syntaxhighlight>
===响应状态代码===
! 状态
! 描述
|-
| 200
| OK（仅当 type 为 json 时）
|-
| 302
| 