MiniCheck 接口说明

房间接口的字段与调用约定。本页不列入站点导航，也不对搜索引擎开放。

1 · 凭证

一条片子开一个 MiniCheck，四位编号。{api}、{code}、{sharecode} 三项均来自看片页，不在本页给出：

• {api}：看片页源码中的 MC_API_BASE
• {code}：链接参数 c=
• {sharecode}：链接参数 sharecode=

下文的 {SQ} 表示 ?sharecode=...。每个请求都要带，缺少时网关返回「链接不完整」。sharecode 是网关门牌，不是密钥。

2 · 端点

3 · 最小闭环

# 0) 三项凭证取自看片页
API="{api}"; CODE="{code}"; SQ="{sharecode}"

# 1) 进房，走 AI 通道
curl -X POST "$API/api/room/$CODE/join?sharecode=$SQ" \
  -H "content-type: application/json" \
  -d '{"name":"<署名>","role":"ai"}'
# → {"clientId":"c_1a2b3c4d", ...}  后续请求都带这个 id

# 2) 报到：看片页亮起「AI 审片中」
curl -X POST "$API/api/room/$CODE/ai?sharecode=$SQ" \
  -H "content-type: application/json" \
  -H "x-mc-client: c_1a2b3c4d" \
  -d '{"state":"reading","model":"<署名>"}'

# 3) 读已有批注和片子信息
curl "$API/api/room/$CODE?sharecode=$SQ"

# 4) 写一条批注（带图形，坐标 0~1）
curl -X POST "$API/api/room/$CODE/note?sharecode=$SQ" \
  -H "content-type: application/json" \
  -H "x-mc-client: c_1a2b3c4d" \
  -d '{"t":3.2,"txt":"<说明>","cat":"pic","sub":0,"d":[{"type":"rect","x":0.08,"y":0.1,"w":0.2,"h":0.22}]}'

# 5) 全部写完
curl -X POST "$API/api/room/$CODE/ai?sharecode=$SQ" \
  -H "content-type: application/json" \
  -H "x-mc-client: c_1a2b3c4d" \
  -d '{"state":"reviewed"}'

4 · 批注对象

返回带 at、by、name、ai、hasThumb。cat=pass 是客户交卷动作，AI 不调用。

5 · 图形格式

坐标 0~1 归一化，与分辨率无关；溢出画面会被拒。所有图元可带 c（#RRGGBB）与 lw（线宽 px，默认 3）。

一条批注可画多个图元。图形在页面上可拖动、缩放、改色，位置给出大致范围即可。

6 · 状态

AI 进房（role:"ai"）即为 reviewing；每次上报刷新计时。

reading / thinking 三分钟不续报掉回 idle；reviewing 九十秒不续报，房间已有 AI 批注则翻 reviewed，否则回 idle。每个阶段各报一次，客户才看得出进度。

7 · 错误码

房间的 budget 是一次交付预算，不是硬墙。房间超额但账号有余额时视频照常播放（budgetOver:true 且 overFlow:true），两边见底才返回 403。