1. 公开表单
KukeMC-群组服 API 文档
  • KukeMC 公共 API 接入指南
  • 公开接口文档
    • 状态与监测
      • 获取 API 状态
      • 获取全部服务器状态
      • 获取单个服务器状态
    • 内容与分类
      • 获取动态分类
      • 获取公开新闻列表
      • 获取公开更新日志
    • 公开表单
      • 获取公开表单列表
        GET
      • 获取公开表单详情
        GET
    • 游戏排行榜
      • 获取 KitBattle 排行榜
      • 获取等级排行榜
    • 在线玩家
      • 获取按服务器分组的玩家列表
      • 获取玩家名单文本
    • 玩家认证
      • 获取玩家公开认证状态
  • 数据模型
    • PublicForm
    • PublicNews
    • PublicChangelog
  1. 公开表单

获取公开表单列表

GET
/api/forms/public
匿名读取,无请求体。skip 默认为 0,limit 默认为 20,均为可选整数,未声明 HTTP 层上下界。先选 status=published 的表单,按创建时间降序并分页,再排除尚未开始或已经结束的项;因此一页可能少于 limit,甚至为空,并非先按时间过滤再分页。时间比较采用 UTC+8 的无时区时间口径,边界以服务端为准。HTTP 200 为 PublicForm 数组,每项计算 submission_count;require_login 不限制列表可见性。只读;类型错误通常为 422,服务、时间或响应兼容性异常可能为 500。

请求参数

Query 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/api/forms/public?skip=0&limit=20'

返回响应

🟢200
application/json
HTTP 200;已声明公共响应模型,具体读取语义见接口说明;未业务验证。
Bodyapplication/json

示例
[
    {
        "id": 0,
        "slug": "string",
        "title": "string",
        "description": "string",
        "cover_image": "string",
        "status": "string",
        "require_login": true,
        "limit_one_per_ip": true,
        "limit_one_per_user": true,
        "schema": null,
        "created_at": "2019-08-24T14:15:22.123Z",
        "updated_at": "2019-08-24T14:15:22.123Z",
        "author_id": "string",
        "start_time": "2019-08-24T14:15:22.123Z",
        "end_time": "2019-08-24T14:15:22.123Z",
        "submission_count": 0
    }
]
⚪default
上一页
获取公开更新日志
下一页
获取公开表单详情
Built with