连接
- 填写
ws://或wss://地址。 - 点击 连接;状态点变绿(已连接)后即可收发消息。
- 再次点击按钮即断开。
消息收发
- 消息日志:接收(绿)/ 发送(蓝)/ 系统(灰)/ 错误(红)分色展示,顶部统计 ↑↓ 条数与连接时长。
- 发送框:支持 JSON / 纯文本;⌘/Ctrl + Enter 快速发送;「格式化 JSON」一键美化。
子协议
「握手配置」标签中的子协议填逗号分隔列表,例如:
graphql-transport-ws, v1.json
自定义握手 Header(隧道模式)
浏览器原生 WebSocket 不能携带自定义 Header(如 Authorization、X-API-Key)。OpsxAPI 的处理方式:
- 「握手配置」中填写 Header 后,工具自动改走本地隧道:
- 浏览器 → 本地代理
/v1/proxy/ws/attach(普通 WS) - 代理 → 目标服务器(携带你填的全部 Header)
- 浏览器 → 本地代理
- 不填 Header 时直连目标,零额外开销。
说明:隧道由应用自带的本地服务提供 —— 桌面版随应用自动运行,无需任何手动配置。
调试技巧
- 消息过多时点「清空」;日志上限 500 条,超出自动滚动淘汰。
- 把常用报文保存在「说明」里,或为不同报文建多个 WS 请求节点。