📦 Microsoft Graph Api — Microsoft Graph API — Microsoft 365 API 集成

Microsoft Graph API 是一个 RESTful Web API，允许您访问 Microsoft 云服务资源。开发者用它来将应用程序与 Microsoft 365 服务（如 Outlook、OneDrive、Azure AD 等）集成。它提供了统一的端点来访问 Microsoft 生态系统中的数据和洞察。

官方文档：https://learn.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0

Microsoft Graph API 概览

• 用户
• 邮箱设置
• 日历

• 联系人
• 云端硬盘

• 组
• 组织

使用 Microsoft Graph API

此技能使用 Membrane CLI 与 Microsoft Graph API 交互。Membrane 自动处理身份验证和凭证刷新——因此您可以专注于集成逻辑而非身份验证流程。

安装 CLI

安装 Membrane CLI 以便您可以从终端运行 membrane：

npm install -g @membranehq/cli

首次设置

membrane login --tenant

浏览器窗口将打开以进行身份验证。

无头环境： 运行命令，将打印的 URL 复制给用户在浏览器中打开，然后使用 membrane login complete 完成。

连接到 Microsoft Graph API

• 创建新连接：

membrane search microsoft-graph-api --elementType=connector --json

从 output.items[0].element?.id 获取连接器 ID，然后：

membrane connect --connectorId=CONNECTOR_ID --json

用户在浏览器中完成身份验证。输出包含新的连接 ID。

获取现有连接列表

当您不确定连接是否已存在时：

• 检查现有连接：

membrane connection list --json

如果存在 Microsoft Graph API 连接，请记下其 connectionId

搜索操作

当您知道想要做什么但不知道确切的操作 ID 时：

membrane action list --intent=QUERY --connectionId=CONNECTION_ID --json

这将返回包含 ID 和 inputSchema 的操作对象，这样您就知道如何运行它了。

热门操作

使用 npx @membranehq/cli@latest action list --intent=QUERY --connectionId=CONNECTION_ID --json 发现可用的操作。

运行操作

membrane action run --connectionId=CONNECTION_ID ACTION_ID --json

传递 JSON 参数：

membrane action run --connectionId=CONNECTION_ID ACTION_ID --json --input "{ \"key\": \"value\" }"

代理请求

当可用的操作无法满足您的用例时，您可以通过 Membrane 的代理直接向 Microsoft Graph API API 发送请求。Membrane 会自动为您提供的路径追加基础 URL 并注入正确的身份验证头——包括凭证过期时的透明刷新。

membrane request CONNECTION_ID /path/to/endpoint

常用选项：