大网数据广告活动
Microsoft Graph 接口

结合使用 Postman 和 Microsoft Graph API

· 52CE 我爱测

Postman 是用于构建和使用 API 的 API 平台。 使用 Microsoft Graph Postman 集合开始使用Microsoft Graph API。

Postman 是用于构建和使用 API 的 API 平台。 Postman 简化了 API 生命周期的每个步骤并简化了协作,使你可以更快地创建更好的 API。

使用 Microsoft Graph Postman 集合,只需几分钟,即可开始使用 Microsoft Graph API。

Postman 图像

本文介绍了如何快速掌握 Postman 和 Microsoft Graph。 此外,还可以使用 Graph 管理器直接在 Web 浏览器中浏览 Microsoft Graph API。

若要详细了解如何使用 Postman,请跟随本文中的步骤进行或观看 Microsoft Graph Postman 工作区入门视频。

步骤 1:分叉 Microsoft Graph Postman 集合

若要使用 Postman 集合,请将其导入到你自己的 Postman 工作区。在 web 浏览器中进行该操作。

  1. 转到 Postman 并登录。
  2. 转到标签名为 Microsoft Graph 的 Postman 集合。
  3. 为你自己的分叉填写标签;任何文本皆可。
  4. 在“工作区”下,请确保在下拉列表中选中“我的工作区”。
  5. 选择“分支集合”。

这会将你重定向至你的工作区中主要 Microsoft Graph Postman 集合的一个分支。

步骤 2 - 下载 Postman 代理(可选 - 仅限 Postman Web 浏览器)

要在 web 浏览器中使用此 Postman 集合,请下载 Postman 桌面代理。 由于 web 浏览器的限制,无法在未下载此代理的情况下在 web 上使用 Postman。

如果你正在使用 Postman for Windows 应用,则不需要此代理。 打开 Postman for Windows 后,你会在工作区中看到这个分支集合。

步骤 3:创建 Azure AD 应用程序

要在自己的开发人员租户中使用此集合,请创建一个 Azure Active Directory (Azure AD) 应用程序,并根据想要调用的请求向其授予合适权限。 如果没有开发者租户,你可以通过 Microsoft 365 开发人员计划注册一个。

  1. 转到 portal.azure.com 并使用开发者租户管理员帐户登录。
  2. 在 Azure 服务 下,选择“Azure Active Directory”。
  3. 在左侧菜单上,选择 注册。
  4. 在水平菜单中,单击“新建注册”。
  5. 将“应用名称”设置为“Postman”。
  6. 从下拉菜单中选择“Web”。
  7. 将“重定向 URI”设置为“https://oauth.pstmn.io/v1/browser-callback”。
  8. 选择“注册”。
  9. 在左侧菜单上,选择 API 权限。
  10. 在水平菜单上,依次选择“添加权限”和“Microsoft Graph”,然后选择“委托的权限”。
  11. 键入 Mail.,展开“邮件”选项,然后选择 Mail.Read。
  12. 选择“应用程序权限”,键入 User.,然后选择“应用程序权限”。
  13. 展开“用户”选项,然后选择 User.Read.All。
  14. 选择 添加权限。
  15. 在水平菜单上,选择“授予管理员同意”,然后选择“是”。
  16. 在左侧的菜单中,选择“概述”。 在这里,可以获取 应用程序(客户端)ID 和 目录(租户)ID。 步骤 4 中将需要使用这些信息。
  17. 在左侧菜单中,选择“证书和机密”。
  18. 选择“新建客户端机密”,输入说明,然后选择“添加”。 将鼠标光标悬停在新客户端机密 值 上并复制它;步骤 4 中需要用到它。

应用程序现在配置了两个权限。 Mail.Read 添加为委托的权限,这是需要登录用户的权限。 应用程序可以代表用户读取邮件。 User.Read.All 添加为应用程序权限,这是不需要登录用户的权限。 应用程序可以在 Azure AD 中读取用户。

步骤 4:配置身份验证

在此步骤中,你将在 Postman 中设置用于检索访问令牌的环境变量。

  1. 转到 分叉。
  2. 为分叉添加标签。 此值可以是任何文本。
  3. 在“工作区”下,请确保在下拉列表中选中“我的工作区”。
  4. 选择“分支环境”。
  5. 在 ClientID 中,将“当前值”设置为步骤 3.16 中的应用程序(客户端)ID 值。
  6. 在 ClientSecret 中,将“当前值”设置为步骤 3.18 中的客户端密码值。
  7. 在 TenantID 中,将“当前值”设置为步骤 3.16 中的目录(租户)ID 值。
  8. 在右上角,选择“保存”。
  9. 关闭" "选项卡 "。
  10. 在右上方的眼睛图标旁边,验证是否已在下拉列表中选择了“M365 环境”,而不是“无环境”。

步骤 5:获取委派的访问令牌

由于这是你第一次以委派身份验证流的形式运行请求,因此,你需要获取访问令牌。

  1. 选择“委派”文件夹。
  2. 选择“授权”选项卡。
  3. 在“配置新令牌”部分,选择“配置选项”选项卡。将所有字段保留为预配置的状态,包括设置为 Authorization Code 的“授权类型”。
  4. 在右侧向下滚动并选择“获取新的访问令牌”。
  5. 使用你的开发者租户管理员账户登录。
  6. 选择“继续”,然后选择“使用令牌”按钮。

你现在已具有用于委派请求的有效访问令牌。

步骤 6:运行你的第一个委派请求

“Delegated”文件夹内是你可以调用的各种 Microsoft Graph 工作负载的请求。

  1. 展开“Delegated”文件夹,然后展开“Mail”文件夹。
  2. 双击“获取我的邮件”来打开请求。
  3. 在右上角,选择“发送”。

你已经成功地使用委派身份验证完成了一次 Microsoft Graph 调用。

步骤 7:获取应用程序访问令牌

由于这是你第一次以应用程序身份验证流的形式运行请求,因此,你需要获取访问令牌。

  1. 选择“应用程序”文件夹。
  2. 选择“授权”选项卡。
  3. 在“配置新令牌”部分,选择“配置选项”选项卡。将所有字段保留为预配置的状态,包括设置为 Client Credentials 的“授权类型”。
  4. 在右侧向下滚动并选择“获取新的访问令牌”。
  5. 选择“继续”,然后选择“使用令牌”按钮。

你现在已具有用于委派请求的有效访问令牌。

步骤 8:运行你的第一个应用程序请求

“Application”文件夹内是你可以调用的各种 Microsoft Graph 工作负载的请求。

  1. 展开“Application”文件夹,然后展开“User”文件夹。
  2. 双击“获取用户”来打开请求。
  3. 在右上角,选择“发送”。

你已经成功地使用应用程序身份验证完成了一次 Microsoft Graph 调用。

你可以按照这些步骤向 Microsoft Graph 发出其他请求。 请记住,你需要向你的 Azure AD 应用程序添加权限来使其他请求正常工作;否则,你将在响应中收到权限被拒的错误。

参与集合

如果想贡献你自己的请求,你需要 Postman 许可。 你可以对分支集合做出更改,然后将鼠标光标悬浮在集合的顶端节点,然后选择“创建拉取请求”。

已知问题

身份验证失败,并显示“无法从此处到达该处”

组织管理员配置的某些条件访问策略可能会阻止来自 Postman 的身份验证流。请联系管理员以了解替代方案。

另请参阅

历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 jasonjoh)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。