使用 GraphQL 查询
使用 GraphQL 查询
除了 REST,Postman 还可以使用 GraphQL(一种用于 API 的开源数据查询和操作语言)进行 HTTP 调用。
您可以通过多种方式使用 Postman 编写和发送 GraphQL 查询:
使用 Postman 对 GraphQL 的内置支持
Postman 内置支持在请求正文中发送 GraphQL 查询、使用 GraphQL 变量以及自省和导入 GraphQL 模式。
在请求正文中发送 GraphQL 查询
- 在 Postman 中打开一个新的请求选项卡,并在地址字段中输入您的 GraphQL 端点 URL。
POST
从请求方法下拉列表中选择。- 在Body选项卡下,选择GraphQL body 类型。
- 在查询编辑器中输入您的 GraphQL 查询。此编辑器使您能够分别创作和编辑查询和变量。
使用 GraphQL 变量
- 在GraphQL 变量编辑器中输入您的GraphQL 变量。
- 在查询编辑器中,在 GraphQL 查询中声明 GraphQL 变量。有关如何使用 GraphQL 变量的更多信息,请参阅GraphQL 变量文档。
您还可以使用 Postman 变量作为 GraphQL 变量的数据输入,使用
{{variable}}
语法。
自省和导入 GraphQL 模式
要启用自动完成,您的请求需要 GraphQL 架构。Postman 将使用 GraphQL 自省根据请求 URL 自动获取模式。当 Postman 能够自动获取模式时,模式选择列表旁边会显示一条消息。如果您的架构已更改,请选择刷新图标以提取更改。

您也可以手动导入架构。当您创建 GraphQL 架构或将其导入 Postman 时,您可以选择它而不是自动获取的架构。
-
在左侧边栏中选择API ,然后选择+以创建新 API。
-
输入 API 的名称和版本。
-
从Schema type下拉列表中选择GraphQL 。
-
从Schema Format下拉列表中选择JSON或GraphQL SDL 。
您可以选择“导入”选项卡直接从本地文件或 GitHub 或 Bitbucket 存储库导入 API 规范。如果您不导入模式,Postman 将使用您可以随时编辑的示例规范填充您的 API。
-
选择创建 API。
-
打开新 API 的版本页面并导航到定义选项卡。在编辑器中输入您的 GraphQL 模式并保存。
-
返回到您的GraphQL正文。从下拉列表中选择您的架构。您可能需要通过选择
刷新图标进行刷新。
-
开始编辑您的查询。Postman 现在将根据新 GraphQL 模式中的数据建议自动完成选项。
在请求正文中使用 JSON
- 在 Postman 中打开一个新的请求选项卡,并在地址字段中输入您的 GraphQL 端点 URL。
POST
从请求方法下拉列表中选择。- 在“标题”选项卡中,添加
Content-type
.application/json
- 在Body选项卡下,选择raw body 类型。从格式下拉列表中选择JSON 。
- 使用正确的 JSON 格式在请求正文中构造您的查询。
使用 GraphQL 内容类型标头
- 在 Postman 中打开一个新的请求选项卡,并在地址字段中输入您的 GraphQL 端点 URL。
POST
从请求方法下拉列表中选择。- 在“标题”选项卡中, 添加
Content-type
.application/graphql
- 在Body选项卡下,选择raw body 类型。从格式下拉列表中选择文本。
- 使用标准 GraphQL 格式在请求正文中构建您的查询。
将查询作为 cURL 请求导入
- 选择左上角的导入。
- 选择原始文本。
- 将您的 cURL 命令粘贴到文本字段中,然后继续。您的 cURL 命令必须包含 GraphQL 端点 URL,并且必须指定
POST
请求方法。 - 选择导入。
- 该请求将在一个新选项卡中打开,其中包含您指定的 GraphQL 端点 URL 和
POST
请求方法。
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】凌霞软件回馈社区,博客园 & 1Panel & Halo 联合会员上线
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】博客园社区专享云产品让利特惠,阿里云新客6.5折上折
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· 微软正式发布.NET 10 Preview 1:开启下一代开发框架新篇章
· C# 集成 DeepSeek 模型实现 AI 私有化(本地部署与 API 调用教程)
· DeepSeek R1 简明指南:架构、训练、本地部署及硬件要求
· 没有源码,如何修改代码逻辑?
· NetPad:一个.NET开源、跨平台的C#编辑器
2023-11-24 XRender - 开源之路
2023-11-24 url-parse
2023-11-24 版本对比的库
2023-11-24 Lodash 真的死了吗?Lodash 5 在哪里?
2023-11-24 低代码的核心思想 如何统一数据的格式
2023-11-24 antd button按钮重要的点
2023-11-24 antd 里面的Checkbox.Group的一个bug