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

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

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

MCBBS Wiki GitHub群组已上线!

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

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

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

MCBBS Wiki:API:修订间差异

来自MCBBS Wiki
跳到导航 跳到搜索
无编辑摘要
无编辑摘要
第13行: 第13行:
| UID || number|| 要查询用户的 UID。 || ✓
| UID || number|| 要查询用户的 UID。 || ✓
|}
|}
===响应===
以 UID 3038 为例。
<syntaxhighlight lang="JSON">
{
"uid": 3038, // 用户 UID
"nickname": "混乱", // 用户名
"credits": {
"heart": 0, // 爱心数
"contribute": 165, // 贡献数
"diamond": 3447, // 钻石数
"popularity": 11454, // 人气数
"credit": 46696, // 积分总数
"nugget": 10648, // 金粒数
"gem": 11, // 宝石数
"ingot": 0, // 金锭数
"star": 1 // 下界之星数
},
"activites": {
"post": 6791, // 回帖数
"thread": 577, // 主题数
"digiest": 4, // 精华数
"userGroups": [ // 用户所拥有的用户组(机器可读)
"admin",
"artist",
"super_moderator"
],
"userGroupsText": [ // 用户所拥有的用户组(人类可读)
"管理员",
"Lv.Inf 艺术家",
"超级版主"
],
"currentGroup": "admin", // 用户当前的用户组(机器可读)
"currentGroupText": "管理员" // 用户当前的用户组(人类可读)
},
"locked": false // 用户是否被锁定
}
</syntaxhighlight>
===响应状态代码===
===响应状态代码===
{| class="wikitable"
{| class="wikitable"
第50行: 第87行:
| type || string || API 返回信息类型。<br>默认值:img<br>可以是以下其中之一:img,json ||
| type || string || API 返回信息类型。<br>默认值:img<br>可以是以下其中之一:img,json ||
|}
|}
===响应===
当 type 为 img 时,将会重定向至{{code|Content-Type}}为{{code|image/webp}}的 webp 图片。

当 type 为 json 时,将返回以下 JSON 数据。
<syntaxhighlight lang="JSON">
{
"id": 3,
"path": "/images/memes/3.webp",
"page": "混乱"
}
</syntaxhighlight>
===响应状态代码===
===响应状态代码===
{| class="wikitable"
{| class="wikitable"
第67行: 第115行:
| 未找到图片。
| 未找到图片。
|}
|}

{{MCBBS Wiki导航}}
{{MCBBS Wiki导航}}
[[Category:Wiki页面]]
[[Category:Wiki页面]]

2022年7月30日 (六) 08:48的版本

本页记录了 MCBBS Wiki 上所有可调用的 API。

关于直接向 MediaWiki 请求数据的API,请参见[1]

积分查询

GET/913-api/users/UID

路径参数

参数名 类型 描述 必须
UID number 要查询用户的 UID。

响应

以 UID 3038 为例。

{
  "uid": 3038, // 用户 UID
  "nickname": "混乱", // 用户名
  "credits": {
    "heart": 0, // 爱心数
    "contribute": 165, // 贡献数
    "diamond": 3447, // 钻石数
    "popularity": 11454, // 人气数
    "credit": 46696, // 积分总数
    "nugget": 10648, // 金粒数
    "gem": 11, // 宝石数
    "ingot": 0, // 金锭数
    "star": 1 // 下界之星数
  },
  "activites": {
    "post": 6791, // 回帖数
    "thread": 577, // 主题数
    "digiest": 4, // 精华数
    "userGroups": [ // 用户所拥有的用户组(机器可读)
      "admin",
      "artist",
      "super_moderator"
    ],
    "userGroupsText": [ // 用户所拥有的用户组(人类可读)
      "管理员",
      "Lv.Inf 艺术家",
      "超级版主"
    ],
    "currentGroup": "admin", // 用户当前的用户组(机器可读)
    "currentGroupText": "管理员" // 用户当前的用户组(人类可读)
  },
  "locked": false // 用户是否被锁定
}

响应状态代码

状态 描述
200 OK
400 请求参数错误。
404 未找到用户或无法访问用户页面。
500 无法从 MCBBS 获取积分信息。

论坛梗图

GET/913-api/imgs/PID

路径参数

参数名 类型 描述 必须
PID number 要查询图片的 PID,未指定则随机抽取。

查询参数

参数名 类型 描述 必须
type string API 返回信息类型。
默认值:img
可以是以下其中之一:img,json

响应

当 type 为 img 时,将会重定向至Content-Typeimage/webp的 webp 图片。

当 type 为 json 时,将返回以下 JSON 数据。

{
  "id": 3,
  "path": "/images/memes/3.webp",
  "page": "混乱"
}

响应状态代码

状态 描述
200 OK(仅当 type 为 json 时)
302 重定向至图片的 URL。
400 请求参数错误。
404 未找到图片。