粘贴 GraphQL Schema(SDL)或内省查询的 JSON 结果,按 Query、Mutation 展开字段树,勾选需要的字段、填写参数,自动生成格式规范的查询语句和变量,以及 fetch、curl、Python 调用代码。支持嵌套对象、联合类型和输入类型参数。要直接向接口发送请求,请用 GraphQL 调试器。
可以粘贴 schema.graphql 的内容,或者内省查询(introspection)返回的 JSON。
勾选对象类型的字段时会自动选上它的第一个普通字段;带 * 的参数为必填。
npx get-graphql-schema https://接口地址 > schema.graphql,或者使用 Apollo Rover:rover graph introspect https://接口地址。展开“编辑 Schema”粘贴自己的 SDL 或内省 JSON(默认是示例博客接口),选择查询或变更,在字段树中勾选字段,勾选带参数的字段后填写参数值;右侧生成查询语句和变量,切换 fetch、curl、Python 代码,填写接口地址后复制。
查询文本保持不变,便于服务端缓存,也避免了手动拼接字符串带来的转义和注入问题。
GraphQL 要求返回对象时明确列出需要的字段,本工具会自动选上第一个普通字段。
使用 ... on 类型名 的片段分别选择各类型的字段,本工具在联合类型下会列出这些片段。
接口开启内省时可以在 GraphQL 调试器中获取,或者向接口提供方索取 schema.graphql 文件。
SDL 解析覆盖 type、interface、input、enum、union、scalar 和 schema 定义,不处理自定义指令的含义;接口类型的具体实现类型片段需要手动补充。
Schema 和生成的查询只在浏览器本地处理,不会发送任何请求。
提示没有找到 Query 类型,检查 Schema 中是否定义了 type Query,或者 schema { query: ... } 指定的类型名是否存在。
GraphQL 调试器 · cURL 命令生成器 · JSON Schema 生成器 · JSON Schema 生成表单 · 全部开发工具