+
+
GET/healthz
+
健康检查接口，用来确认服务是否存活。
+
+
+
+
+
POST/auth/sms/send
+
发送短信验证码，支持登录和绑定手机号两种场景。
+
+
+
+
+
POST/auth/login/sms
+
APP 主登录入口，使用手机号验证码登录并返回 access/refresh token。
+
+
+
+
+
POST/auth/login/wechat-mini
+
微信小程序登录入口。开发环境支持 dev- 前缀 code 直接模拟登录。
+
+
+
+
+
POST/auth/bind/mobile
+
已登录用户绑定手机号，必要时把微信轻账号合并到手机号主账号。
+
+
+
+
+
POST/auth/refresh
+
使用 refresh token 刷新 access token。
+
+
+
+
+
POST/auth/logout
+
登出并撤销 refresh token。
+
+
+
+
+
GET/entry/resolve
+
解析当前入口属于哪个 tenant / channel，是多俱乐部、多公众号接入的入口层基础接口。
+
+
+
+
+
GET/home
+
返回入口首页卡片数据。
+
+
+
+
+
GET/cards
+
只返回卡片列表，适合调试卡片数据本身。
+
+
+
+
+
GET/me/entry-home
+
首页聚合接口，返回用户、tenant、channel、cards、进行中 session 和最近一局。
+
+
+
+
+
GET/events/{eventPublicID}
+
活动详情接口，会带当前发布的 release 和 resolvedRelease。
+
+
+
+
+
GET/events/{eventPublicID}/play
+
活动详情页 / 开始前准备页聚合接口，判断是否可启动、继续还是查看上次结果。
+
+
+
+
+
POST/events/{eventPublicID}/launch
+
基于当前 event 的已发布 release 创建一局 session，并返回 config URL、releaseId、sessionToken。
+
+
+
+
+
GET/events/{eventPublicID}/config-sources
+
查看某个 event 下已经导入过的 source config 列表。
+
+
+
+
+
GET/config-sources/{sourceID}
+
查看单条 source config 明细。
+
+
+
+
+
GET/config-builds/{buildID}
+
查看单次 build 的 manifest 和 asset index。
+
+
+
+
+
GET/sessions/{sessionPublicID}
+
查询一局详情，带 session 状态、event 和 resolvedRelease。
+
+
+
+
+
POST/sessions/{sessionPublicID}/start
+
把 session 从 launched 推进到 running。
+
+
+
+
+
POST/sessions/{sessionPublicID}/finish
+
结束一局并沉淀结果摘要，是结果页数据的来源。
+
+
+
+
+
GET/me/sessions
+
查询用户最近 session 列表。
+
+
+
+
+
GET/sessions/{sessionPublicID}/result
+
单局结果页接口，返回 session 和 result。
+
+
+
+
+
GET/me/results
+
查询用户最近结果列表。
+
+
+
+
+
GET/me
+
返回当前用户基础信息。
+
+
+
+
+
GET/me/profile
+
“我的页”聚合接口，返回绑定概览、绑定项列表和最近记录摘要。
+
+
+
+
+
POST/dev/bootstrap-demo
+
开发态自举 demo 数据，会准备 tenant、channel、event、release、card、source、build。
+
+
+
+
+
GET/dev/config/local-files
+
列出本地配置目录中的 JSON 文件，作为 source config 导入入口。
+
+
+
+
+
POST/dev/events/{eventPublicID}/config-sources/import-local
+
从本地 event 目录导入 source config。
+
+
+
+
+
POST/dev/config-builds/preview
+
基于 source config 生成 preview build，并产出 preview manifest。
+
+
+
+
+
POST/dev/config-builds/publish
+
把成功的 build 发布成正式 release，并自动切换成当前 event 的可启动版本。
+
+
+