OpsxAPI 文档 v1.0

GraphQL

更新于 2026-09-17

编辑查询

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 请求。