MCBBS Wiki:API:修订间差异

删除1,217字节 、​ 2024年2月25日 (星期日)
→‎响应:​ // Edit via Wikiplus
→‎响应:​ // Edit via Wikiplus
→‎响应:​ // Edit via Wikiplus
 
(未显示同一用户的12个中间版本)
 
关于直接向 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|/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 获取积分信息。
|}
 
==论坛梗图==
<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
维护员、​界面管理员、​巡查员、​监督员、​小部件编辑者
3,462

个编辑