const ExternalApiPage = { async render() { return '
暂无客户端
| # | 名称 | Client ID | 状态 | 创建时间 | 操作 |
|---|---|---|---|---|---|
| ${c.id} | ${U.esc(c.name)} | ${U.esc(c.client_id)} |
${c.active ? '启用' : '停用'} | ${U.date(c.created_at)} |
POST /api/external/auth/session 用 x-api-client-id + x-api-secret 换取 SESSION(24小时有效), 之后所有接口请求头用 Authorization: Bearer <SESSION>。secret 仅创建时显示一次,请立即保存。| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /api/external/auth/session | ID+Secret 换取 SESSION(唯一使用 ID+Secret 的接口) |
| POST | /api/external/auth/register | 插件注册账号(需 SESSION) |
| POST | /api/external/tickets | 提交工单(举报/建议/申诉),返回 id + tracking_token;可带 server(别名或「分组/子服」) |
| GET | /api/external/tickets/track?token=xxx | 按追踪码查工单状态 + 回复,从提交到结束全程可查 |
| GET | /api/external/all-tickets?server=&status=&type=&page=&limit= | 工单列表(可按子服过滤) |
| GET | /api/external/all-tickets/:id | 工单详情(含回复/附件) |
| GET | /api/external/bans?server=&status=&player= | 拉取封禁列表 |
| POST | /api/external/bans | 新增封禁(可带 server) |
| GET | /api/external/reported-players?server= | 被举报人统计 |
| GET | /api/external/servers | 服务器列表(含别名) |
| GET | /api/external/stats?server= | 工单统计 |
| POST | /api/external/clients | 创建客户端(需登录态, 本页操作) |
完整请求/响应示例见 docs/API.md 外部API章节。
请立即保存以下凭据(secret 只显示一次):