API 接口文档

基础 URL

https://lianban.fivemzh.cn/api

所有请求均需携带 api_key 参数。

1. 检查封禁 Check Ban (GET)

查询玩家是否被全网封禁。

/check_ban?api_key=KEY&identifier=steam:xxxxx

2. 获取统计 Stats (GET)

获取全网封禁总数。

/stats?api_key=KEY

3. 提交封禁 Submit Ban (POST)

提交新的封禁申请。

POST /submit_ban
Body: {
  api_key: "KEY",
  identifier: "steam:xxxxx",
  reason: "Reason",
  evidence: "URL"
}

4. 移除封禁 Remove Ban (POST)

⚠️ 重要变更

此接口现在会创建解除申请而非直接删除。需要管理员审核后才会删除封禁记录。建议使用新接口 /request_unban。

移除自己提交的封禁（已废弃，建议使用 request_unban）。

POST /remove_ban
Body: {
  api_key: "KEY",
  id: 123
}

5. 全网列表 List Bans (GET)

/list_bans?api_key=KEY

6. 我的提交 My Bans (GET)

/my_bans?api_key=KEY

7. 申请解除封禁 Request Unban (POST)

提交解除封禁申请，需要管理员审核。

POST /request_unban
Body: {
  api_key: "KEY",
  ban_id: 123,
  reason: "误封/证据不足等理由"
}

响应示例：
{"success": true, "message": "Unban request submitted, waiting for admin approval"}

8. 我的解除申请 My Unban Requests (GET)

查询自己提交的所有解除申请及其审核状态。

/my_unban_requests?api_key=KEY

返回字段：
- id: 申请ID
- ban_id: 封禁记录ID
- identifier: 封禁标识符
- reason: 申请理由
- status: 审核状态 (pending/approved/rejected)
- created_at: 申请时间
- reviewed_at: 审核时间