MCBBS Wiki欢迎您共同参与编辑!在参与编辑之前请先阅读Wiki方针。
如果在编辑的过程中遇到了什么问题,可以去讨论板提问。
为了您能够无阻碍地参与编辑 未验证/绑定过邮箱的用户,请尽快绑定/验证。
MCBBS Wiki GitHub群组已上线!
您可以在回声洞中发表吐槽!
服务器状态监控。点击进入
本站由MCBBS用户自行搭建,与MCBBS及东银河系漫游指南(北京)科技有限公司没有从属关系。点此了解 MCBBS Wiki 不是什么>>
MCBBS Wiki:API:修订间差异
跳到导航
跳到搜索
无编辑摘要 |
(→响应: // Edit via Wikiplus) |
||
(未显示同一用户的23个中间版本) | |||
第1行: | 第1行: | ||
本页记录了 MCBBS Wiki 上所有可调用的 API。 |
本页记录了 MCBBS Wiki 上所有可调用的 API。 |
||
关于直接向 MediaWiki 请求数据的API,请参见[https://mcbbs.wiki/api.php] |
关于直接向 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" |
||
|+ 路径参数 |
|||
! 类型 |
|||
! 描述 |
|||
! 必须 |
|||
|- |
|- |
||
⚫ | |||
⚫ | |||
===查询参数=== |
|||
{| class="wikitable" |
|||
! 参数名 |
! 参数名 |
||
! 类型 |
! 类型 |
||
第47行: | 第73行: | ||
! 必须 |
! 必须 |
||
|- |
|- |
||
⚫ | |||
| type || string || API 返回信息类型。<br>默认值:img<br>可以是以下其中之一:img,json || |
|||
| number |
|||
⚫ | |||
|} |
|} |
||
===响应=== |
|||
重定向至图片的 URL,所有图片均为 webp 格式。 |
|||
===响应状态代码=== |
===响应状态代码=== |
||
{| class="wikitable" |
{| class="wikitable" |
||
! 状态 |
! 状态 |
||
! 描述 |
! 描述 |
||
|- |
|||
⚫ | |||
| OK(仅当 type 为 json 时) |
|||
|- |
|- |
||
| 302 |
| 302 |
||
第66行: | 第94行: | ||
| 未找到图片。 |
| 未找到图片。 |
||
|} |
|} |
||
{{MCBBS Wiki导航}} |
{{MCBBS Wiki导航}} |
||
[[Category:Wiki页面]] |
[[Category:Wiki页面]] |
2024年2月25日 (日) 10:05的最新版本
本页记录了 MCBBS Wiki 上所有可调用的 API。
关于直接向 MediaWiki 请求数据的API,请参见[1]
积分查询
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 | 未找到图片。 |
|