SuperAPI AI 工具集

microsoft-graph-api

编程与开发

查看项目

更新于 10-16 05:07

技能介绍

用途:为 M365 服务集成提供 Microsoft Graph API 综合参考,覆盖端点、认证、权限、限流与最佳实践。资料标注最后验证时间为 2026 年 2 月(Graph v1.0、MSAL 2.x),并提示 API 频繁演进,权限与认证流程可能变化。

主要能力:基础 URL 分生产 v1.0、beta 与中国(21Vianet)环境,建议生产用 v1.0。认证分委托(用户)与应用两种,均用 Authorization: Bearer {token};建议用 MSAL 处理缓存、刷新与重试。权限按最小特权原则,先 User.Read 再增量申请。端点覆盖用户、邮件、日历、Presence、People、SharePoint/OneDrive、Planner、To Do、Groups/Teams、服务健康、审计日志、敏感度标签。支持 OData 查询参数($select、$filter、$orderby、$top、$skip、$expand、$count、$search)、@odata.nextLink 分页与 JSON 批处理(单次最多 20 个请求)。

使用方式:资料给出 TypeScript 客户端模式,含超时、重试、429 处理与指数退避;graphBatchAll() 可自动分块。SDK 包括 @microsoft/microsoft-graph-client、msgraph-sdk-python、Microsoft.Graph(PowerShell 与 .NET)。

限制:Planner 仅支持委托权限;服务健康 1,500 请求/10 分钟,安全端点 150 请求/10 分钟,审计日志 1,000 请求/10 分钟;部分端点不支持全部 OData 参数;beta 端点可能无通知变更;Microsoft 租户需管理员同意。具体价格与平台支持暂未提供。