当前为2.0版本。官方API后端仅供内部使用！
©2026 P.C.T.G All Rights Reserved.
欢迎来到 ChineseIdomWordle API Docs
项目简介
怎么玩呢
Question？
Hmm...
接口列表
游戏接口
| 接口 | 方法 | 说明 |
|---|---|---|
/api/games | POST | 创建新游戏 |
/api/games/{game_id}/guesses | POST | 提交猜词 |
/api/games/{game_id}/hints | GET | 使用提示 |
/api/games/{game_id} | GET | 获取游戏状态 |
/api/games/{game_id}/reveal | GET | 强制揭示答案 |
排行榜接口
| 接口 | 方法 | 说明 |
|---|---|---|
/api/leaderboard/upload | POST | 首次上传战绩创建存档 |
/api/leaderboard/append | POST | 追加新战绩到已有存档 |
/api/leaderboard/daily/submit | POST | 提交每日挑战成绩到日榜 |
/api/leaderboard/{difficulty} | GET | 获取用户总榜（三种榜单） |
/api/leaderboard/{difficulty}/daily | GET | 获取每日挑战排行榜 |
/api/leaderboard/profile/me | GET | 获取个人存档 |
/api/leaderboard/profile/delete | GET | 删除个人存档 |
difficulty 可选值:easy - 简单medium - 中等（默认）hard - 困难管理员接口
/api/admin/* 接口需要管理员Token鉴权（Bearer Token）且来源IP在白名单中。| 接口 | 方法 | 说明 |
|---|---|---|
/api/admin/tokens/add | POST | 添加API Token |
/api/admin/tokens | GET | 查询Token列表 |
/api/admin/tokens/delete | POST | 删除Token |
/api/admin/config/reload | GET | 热重载配置 |
/api/admin/config/clean | POST | 立即清理过期对局 |
/api/admin/leaderboard/users | GET | 查询排行榜用户列表 |
/api/admin/leaderboard/delete | POST | 删除用户存档 |
/api/admin/leaderboard/clean-daily | GET | 清空日榜 |
/api/admin/leaderboard/clean-inactive | GET | 清理不活跃用户 |
认证说明
1.
Authorization: Bearer <token>，token需要通过管理员接口添加到数据库2.
admin_token_hash 对应的原始Token3.