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

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

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

MCBBS Wiki GitHub群组已上线！

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

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

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

MCBBS Wiki:API：修订间差异

来自MCBBS Wiki
跳到导航 跳到搜索
可视化wikitext
小 （// Edit via Wikiplus）
（→‎积分查询：​ // Edit via Wikiplus）
第11行： 第11行：
</syntaxhighlight>
</syntaxhighlight>
==积分查询==
==积分查询==
<code style="background-color:#3bd671;color:#ffffff;border-color:#3bd671;">GET</code>  {{code|/913-api/users/UID}}
<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
   "uid": 3038,
   "nickname": "混乱", // 用户名
  "update": "2023-07-11 06:51:25",
  "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,
     "userGroups": [ // 用户所拥有的用户组标签（机器可读）
     "currentGroupID": 28,
      "admin",
     "currentGroupText": "Lv.11 领主"
      "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]

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 未找到图片。
MCBBS Wiki导航
规章制度
讨论与申请
编辑与维护
帮助与指引
取自“https://mcbbs.wiki/index.php?title=MCBBS_Wiki:API&oldid=50027”