Files
opsxapi/apps/server/internal/docs/content/09-sse.md
T
logan dec66db5aa feat: OpsxAPI v1.0 全协议接口工作台
- 六协议调试:HTTP/GraphQL/WebSocket/SSE/Socket.IO/MQTT
- 集合树/多标签/多环境变量/历史记录,localStorage 持久化
- 导入:OpenAPI 2/3/3.1、Postman、Apifox、Apipost、cURL、HAR、
  Insomnia、Hoppscotch、Markdown(自动识别,21 个单测覆盖)
- 导出:OpenAPI 3.0 JSON/YAML、Postman v2.1、Markdown 文档、
  全量备份;单请求生成 cURL/fetch/Python/Go 代码
- Gin 服务:HTTP 代理、NDJSON 流式代理(SSE 透传)、
  WebSocket 隧道(浏览器自定义握手 Header)
- 内置产品官网 /home 与用户文档站 /docs(SSR,随二进制交付)
- lucide 图标体系 + 品牌标识(Logo/favicon),明暗双主题
- 环境变量:彩色徽标切换器、管理弹窗、{{ 自动补全
2026-09-18 00:16:59 +08:00

1.1 KiB
Raw Blame History

连接事件流

  1. 填写 SSE 地址(如 https://stream.wikimedia.org/v2/stream/recentchange)。
  2. 点击 连接,事件按到达顺序流入消息日志。
  3. 每条消息按 event: 名称归类显示;data 为 JSON 时自动格式化。

直连与代理自动切换

  • 默认直连目标站(fetch 流式读取,延迟最低)。
  • 直连因 CORS / 网络失败时,自动降级走本地 Gin 流式代理,日志中会提示切换过程,无需手工干预。

断点续传(Last-Event-ID)

「连接配置」中填写 Last-Event-ID,连接时以 Last-Event-ID 请求头携带,支持断点续传的流会在该事件之后继续推送。

连接配置项

配置 说明
Query 参数 / Headers 以键值对附加
Last-Event-ID 断点续传游标
仅显示 data 内容 开启后只显示 data: 载荷;关闭则连同 event: 名称一起显示
鉴权 与 HTTP 相同(Bearer / Basic / API Key)

典型场景

  • LLM 流式输出接口(text/event-stream)
  • 监控 / 审计事件流
  • 需要长期挂机观察的推送通道