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

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

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

MCBBS Wiki GitHub群组已上线!

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

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

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

MCBBS Wiki:API:修订间差异

来自MCBBS Wiki
跳到导航 跳到搜索
(api页面)
 
→‎响应:​ // Edit via Wikiplus
 
(未显示2个用户的26个中间版本)
第1行: 第1行:
本页记录了 MCBBS Wiki 上所有可调用的 API。
本页记录了 MCBBS Wiki 上所有可调用的 API。


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

[https://github.com/mcbbs-wiki/wiki-api GitHub 仓库]
==积分查询==
==积分查询==
<code style="background-color:#3bd671 !important;color:#ffffff;border-color:#3bd671;">GET</code> {{code|/rest.php/mbwutils/v0/credit/UID}}
{{code|GET}}{{code|/913-api/users/UID}}
===路径参数===
===参数===
{| class="wikitable"
{| class="wikitable"
|+ 路径参数
! 参数名
! 参数名
! 类型
! 类型
第12行: 第16行:
| UID || number|| 要查询用户的 UID。 || ✓
| UID || number|| 要查询用户的 UID。 || ✓
|}
|}
===响应===
以 UID 3038(混乱)为例。
<syntaxhighlight lang="JSON">
{
"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 领主"
}
}
</syntaxhighlight>
===响应状态代码===
===响应状态代码===
{| class="wikitable"
{| class="wikitable"
第29行: 第61行:
| 无法从 MCBBS 获取积分信息。
| 无法从 MCBBS 获取积分信息。
|}
|}

==论坛梗图==
==论坛梗图==
<code style="background-color:#3bd671 !important;color:#ffffff;border-color:#3bd671;">GET</code> {{code|/bbs-img/PID}}
{{code|GET}}{{code|/913-api/imgs/PID}}
===路径参数===
===参数===
{| class="wikitable"
{| class="wikitable"
! 参数
|+ 路径参数
! 类型
! 描述
! 必须
|-
|-
| PID || number|| 要查询图片的 PID,未指定则随机抽取。 ||
|}
===查询参数===
{| class="wikitable"
! 参数名
! 参数名
! 类型
! 类型
第47行: 第73行:
! 必须
! 必须
|-
|-
| PID
| type || string || API 返回信息类型。<br>默认值:img<br>可以是以下其中之一:img,json ||
| number
| 要查询图片的 PID,未指定则随机抽取。
|}
|}
===响应===
重定向至图片的 URL,所有图片均为 webp 格式。

===响应状态代码===
===响应状态代码===
{| class="wikitable"
{| class="wikitable"
! 状态
! 状态
! 描述
! 描述
|-
| 200
| OK(仅当 type 为 json 时)
|-
|-
| 302
| 302
第66行: 第94行:
| 未找到图片。
| 未找到图片。
|}
|}
{{MCBBS Wiki导航}}
[[Category:Wiki页面]]

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