MCBBS Wiki:API:修订间差异

删除921字节 、​ 2024年2月25日 (星期日)
→‎响应:​ // Edit via Wikiplus
→‎积分查询:​ // Edit via Wikiplus
→‎响应:​ // Edit via Wikiplus
 
(未显示同一用户的6个中间版本)
第4行: 第4行:


[https://github.com/mcbbs-wiki/wiki-api GitHub 仓库]
[https://github.com/mcbbs-wiki/wiki-api GitHub 仓库]
==错误信息格式==
<syntaxhighlight lang="JSON">
{
    "message":"错误的详细信息"
}
</syntaxhighlight>
==积分查询==
==积分查询==
<code style="background-color:#3bd671;color:#ffffff;border-color:#3bd671;">GET</code>  {{code|/rest.php/mbwutils/v0/credit/3038}}
<code style="background-color:#3bd671 !important;color:#ffffff;border-color:#3bd671;">GET</code>  {{code|/rest.php/mbwutils/v0/credit/UID}}
===参数===
===参数===
{| class="wikitable"
{| class="wikitable"
第69行: 第63行:


==论坛梗图==
==论坛梗图==
<code style="background-color:#3bd671;color:#ffffff;border-color:#3bd671;">GET</code>  {{code|/913-api/imgs/PID}}
<code style="background-color:#3bd671 !important;color:#ffffff;border-color:#3bd671;">GET</code>  {{code|/bbs-img/PID}}
===参数===
===参数===
{| class="wikitable"
{| class="wikitable"
第82行: 第76行:
| number  
| number  
| 要查询图片的 PID,未指定则随机抽取。  
| 要查询图片的 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 格式。
重定向至图片的 URL,所有图片均为 webp 格式。
 
当 type 为 json 时,将返回以下 JSON 数据。
<syntaxhighlight lang="JSON">
{
  "id": 3, // 图片 PID
  "path": "/images/memes/3.webp", // 图片的相对 URL
  "page": "挖掘卡", // 图片对应的 Wiki 页面
  "small": 0 // 图片的大小,0 为正常大小,1 为宽度较窄
}
</syntaxhighlight>


===响应状态代码===
===响应状态代码===
第123行: 第84行:
! 状态
! 状态
! 描述
! 描述
|-
| 200
| OK(仅当 type 为 json 时)
|-
|-
| 302  
| 302  
维护员、​界面管理员、​巡查员、​监督员、​小部件编辑者
3,469

个编辑