Files
opsxapi/apps/server/internal/docs/content/07-graphql.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.0 KiB
Raw Blame History

编辑查询

GraphQL 请求由三部分组成:

部分 说明
Query GraphQL 查询语句,支持变量定义 $code: ID!
Variables JSON 对象,随查询一起发送;非法 JSON 会红框提示
Headers / Auth 与 HTTP 请求一致

发送

点击 执行(或 URL 栏按 Enter)。实际发送的是标准 GraphQL over HTTP:

{
  "query": "query ($code: ID!) { country(code: $code) { name capital currency } }",
  "variables": { "code": "CN" }
}

响应面板会自动格式化 data / errors,字段名高亮。

内置示例

示例集合中的「国家查询 · countries」连接公共 GraphQL 服务 https://countries.trevorblades.com/graphql,无需鉴权,可直接体验。

最佳实践

  • 把 endpoint 存为 {{baseUrl}}/graphql,环境切换即切换网关。
  • 需要鉴权时在 Auth 标签配置 Bearer,不必手写 Header。
  • 想看实际报文?点 </> 代码 生成 cURL,即为此查询的完整 HTTP 请求。