实例健康 + 战役状态 + 当前地图。健康检查用 GET /health（200 即活）。

翻聊天记录（注意：DICE_ROLL 类不入聊天史，骰史看 events_poll）。

拉取 seq > since 的实时事件（玩家发言/骰子/移动），含骰史。 返回 {events, latest_seq}；把 latest_seq 存下当下次的 since 即可增量拉。

地图列表。

查先攻（最近一条 initiative.state 广播；无则提示尚未开战）。

角色列表（战役 roster）。

读角色卡全量（卡面结构随战役系统：5e/PF2e/SR6/CoC7e 各自 schema）。

用角色卡自身 gameSystem 的 Zod schema 重验 data（服务器侧校验）。 返回 {isValid, errors?}——校验不通过也是 200，看 isValid 字段。

Open5e SRD + 战役自定义怪库检索。source: srd|custom。 系统门：source=srd 仅 DND_5E 战役（Open5e 是 D&D 5e 数据源）；custom 不限系统。

DM 叙事 / NPC 台词。type 仅接受 DM / PLAYER（上游校验，2026-09-04 实测）。

公证骰，如 1d20+5 / 2d6 / 4d6kh3。is_secret=true 暗骰（仅 DM 可见）。 客户端侧最小间隔 2.1s（WS 限流 30/min），排队不报错。

切当前图（WS 会广播 map.changed）。

放 token 到地图（DM only）。

移动 token（REST PUT position；WS 广播 map.changed 同步全桌）。

改 token HP（delta 正=治疗 负=伤害，播报全桌 character.hp.updated）。

先攻管理（全 DM-only）。 action: add / remove / roll / set / reorder / start / next / end。

• add: token_id + map_id

• remove: token_id

• roll: token_id + map_id（expression 可选；服务器按战役系统自行推导骰式—— 5e=敏捷+卡面 initiativeBonus，PF2e 用 usedStat，SR6 用自身先攻骰，客户端给的 expression 仅在无法推导时兜底。系统门：CoC7e 不骰先攻、DEX 排序，请 add 后直接 start，或用 set 手动定值）

• set: token_id + map_id + value（手动定先攻值，服务器按值重排序）

• reorder: ordered_token_ids（自定义回合顺序，覆盖值排序） 状态经 initiative_state / events_poll 回收。

局部更新角色卡（SAN/HP/Luck/MP/法术位等结算由调用方算好传入，桥不做规则计算）。 data 为要 PUT 的字段 dict。

创建角色卡并直接加入当前战役。gameSystem 自动继承战役系统 （服务器会按该系统 Zod schema 校验 data，校验失败返回 400）。 data 为卡面字段 dict（结构随系统：5e 见上游 dnd5e.ts，CoC7e 见 callOfCthulhu7e.ts）。 建完可用 character_validate 复查。

调怪上图：读怪库模板 → 以模板名/图放置 token。

场次管理（DM only）。action: start / pause / end。