GraphQL 调试器

填写接口地址、请求头和变量,发送 GraphQL 查询或变更,格式化查看响应、状态码、耗时和错误信息;还可以通过内省获取接口的 Schema 并转换为 SDL 文本。请求从你的浏览器直接发往接口,不经过 IPKK.COM 的服务器,最近的请求会保存在本机。

示例接口:
点“发送”后在这里查看响应。

请求失败怎么办

  • 跨域(CORS)限制:网页里的请求受浏览器同源策略约束,接口需要返回 Access-Control-Allow-Origin 响应头才能被网页读取。提示“无法连接或被跨域限制”时,多半是接口没有允许跨域,这是浏览器的限制,任何在线网页工具都绕不过去。可以点“复制为 curl”在终端执行,或者在接口的 CORS 设置中加入当前网站。
  • HTTP 200 也可能出错:GraphQL 的业务错误通常放在响应的 errors 数组里,状态码仍然是 200,工具会在上方单独提示错误条数和内容。
  • 获取 Schema 失败:生产环境常常关闭内省查询,会返回“introspection is not allowed”之类的错误,需要向接口提供方索取 schema 文件。
  • 令牌安全:请求头不会保存到最近记录中,但仍建议在测试环境中使用临时令牌。

拿到 Schema 后,可以在 GraphQL 查询构建器 中勾选字段生成查询。

GraphQL 调试器常见问题

GraphQL 调试器怎么使用?

填写接口地址,在查询框写查询(可点“格式化”整理缩进),变量框填写 JSON,需要认证时在请求头中填写 Authorization;点“发送”查看响应、状态码、耗时和错误,点“获取 Schema”内省并转换为 SDL;最近的请求可以从下拉框恢复,也可以复制为 curl。

GraphQL 请求怎么发送?

一般用 POST 方法,请求体为包含 query 和 variables 的 JSON,Content-Type 为 application/json。

为什么返回 200 但没有数据?

GraphQL 把业务错误放在响应的 errors 字段中,状态码仍是 200,工具会单独提示这些错误。

什么是内省查询?

查询 __schema 获取接口的全部类型和字段,开发工具用它来实现自动补全和文档。

请求失败提示跨域怎么办?

这是浏览器的安全限制,需要接口返回 Access-Control-Allow-Origin 响应头,或者改用 curl 等命令行工具。

GraphQL 调试器的结果应怎样理解?

接口需要允许跨域访问(CORS)才能在网页中读取响应;不支持订阅(subscription)的 WebSocket 连接和文件上传。

输入内容会保存或发给外部服务吗?

请求从浏览器直接发往你填写的接口,不经过 IPKK.COM 服务器;最近 20 条请求的地址、查询和变量保存在本机浏览器中,请求头不会保存。

没有结果或操作失败时先检查什么?

提示无法连接或被跨域限制时,确认地址正确并且接口允许跨域;可以复制为 curl 在终端中执行验证。

相关工具

GraphQL 查询构建器 · cURL 命令生成器 · JavaScript 在线运行 · JSON Schema 生成器 · 全部开发工具