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

获取公开表单详情

GET
/api/forms/{id_or_slug}
本公开文档仅描述匿名分支,不要求或发送身份凭据。id_or_slug 为必填字符串,未声明长度或 slug 格式限制;纯数字先按数字 ID 查找,未找到时再按原字符串 slug 查找。匿名仅可读取 status=published 的表单;不存在或不可公开时为 404,提示分别为 Form not found 或 Form not available。require_login、start_time、end_time 不限制详情可见性,不能据此推断是否可提交。HTTP 200 为 PublicForm;详情不重新计算 submission_count,该值通常为默认 0,不应当作实时提交数。静态 /api/forms/public 优先匹配,slug 为 public 的表单可用数字 ID 读取。只读;特殊数字字符转换或服务、响应兼容性问题可能为 500。私人扩展不在本公开范围。

请求参数

Path 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/api/forms/FORM_SLUG_PLACEHOLDER'

返回响应

🟢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
上一页
获取公开表单列表
下一页
获取 KitBattle 排行榜
Built with