接口说明 / pending_events

通话信令 · pending_events（方案 A）

给 中国宇宙研究院 App 合码。院长定：HTTP 轮询 pending_events；一期暂不上正式 WebSocket。

Base 与鉴权

项	值
Base	https://api.menling.com
鉴权	Authorization: Bearer <JWT>（与发信一致；亦可现网登录 Cookie）
Content-Type	application/json; charset=utf-8

接口

方法	路径	说明
GET / POST	/message/call/pending_events	返回当前用户未读通话事件；拉取即消费；可选 callId 过滤

事件类型：call.invite | ringing | accept | reject | hangup | cancel | timeout | sdp | ice

• 内存队列 TTL 约 30 秒（过期不再返回）
• 单用户有上限；请按时轮询，勿长时间不拉

App 轮询建议

场景	间隔
通话页（进行中）	约 1 秒
前台来电侦听	约 3 秒

按返回的 event / payload 驱动通话状态机。一期不必接正式 WebSocket。

联调

1. 登录拿 JWT。
2. A 调 POST /message/call/invite。
3. B 轮询 GET /message/call/pending_events，应收到 call.invite。
4. 再拉应为空（已消费）。
5. ringing / accept / sdp / ice / hangup 同理经 pending 互达。

完整语音/视频状态机见 语音+视频 WebRTC。