使用 Postman 试用 Microsoft Graph 连接器 API
Microsoft Graph Postman 集合包括连接器 API 的示例请求。 开发人员可以使用 Postman 来试用 API，而无需编写任何代码。
先决条件
- 创建 Microsoft Graph Postman 集合的分支。
- 将
ExternalConnection.ReadWrite.OwnedBy和ExternalItem.ReadWrite.OwnedBy权限添加到为 Postman 创建的应用注册。 - 使用 Postman 通过仅限应用的身份验证进行身份验证。
连接器 API 请求位于 Application ->Graph 连接器 文件夹中。
创建新连接
在“连接设置”文件夹中找到“创建连接”示例请求。 使用此示例请求创建新连接。 “连接设置”文件夹还包含用于管理连接的其他示例请求。
注册连接架构
在“连接设置 ->管理架构”文件夹中找到“注册架构示例”请求。 使用此示例请求为创建的连接注册架构。 此请求返回如下所示的响应。
HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/v1.0/external/connections/sampleConnectionId/operations/616bfeed-666f-4ce0-8cd9-058939010bfc
注册架构是一种异步操作。 在标头中返回的 Location URL 应轮询此操作的状态，直到状态为 completed。 在“连接设置”文件夹中找到“获取操作状态”示例请求。 将请求 URL 替换为标头中的 值，Location并将请求发送到检查状态。 此请求返回如下所示的响应。
HTTP/1.1 200 OK
Content-type: application/json
{
"id": "616bfeed-666f-4ce0-8cd9-058939010bfc",
"name": "Sample connection",
"status": "inprogress",
"error": null
}
重新发送请求，直到 属性 status 设置为 completed。 在重新发送此请求之间至少等待一分钟。
“管理架构”文件夹还包含用于管理连接的其他示例请求。
添加外部组成员 (可选)
如果外部服务使用非Microsoft Entra ID访问控制列表 (ACL) ，请同步这些权限。 (外部组以及Microsoft Entra ID用户和组) 用于设置添加到 Microsoft Graph 连接的权限externalItems。 有关详细信息，请参阅 externalGroup。
创建外部组和添加成员的示例请求位于 “标识同步” 文件夹中。
引入项
注意
在连接架构处于 completed 状态之前，不要将项引入连接。
在内容同步文件夹中找到 Put 项目示例请求。 使用此示例请求引入项。 内容同步文件夹还包含用于管理项目的其他示例请求。
错误处理
要详细了解如何解决错误，请参阅 解决 Microsoft Graph 授权错误。