核心用法
SharePoint Skill 是 Maton 平台提供的 Microsoft Graph API 代理服务，采用托管式 OAuth2 认证，支持开发者以 RESTful 方式操作 SharePoint 站点、列表、文档库及文件。用户需配置 MATON_API_KEY 环境变量，通过 https://gateway.maton.ai/sharepoint/ 网关转发请求，平台自动注入 OAuth Token 完成鉴权。
主要功能模块
- 站点管理：获取根站点、按ID/路径查询站点、搜索站点、列举子站点
- 列表操作：CRUD 列表项，支持
$expand=fields获取自定义字段 - 文档库（Drive）：管理驱动器、文件夹创建、文件上传下载（单文件≤4MB）
- 版本与权限：文件版本追溯、生成共享链接（view/edit/embed）、权限查询
- 高级查询：完整支持 OData 参数（
$select$filter$orderby$top等）
显著优点
1. 零OAuth运维成本：Maton 托管 token 刷新与生命周期管理，开发者仅需单一 API Key
2. 原生Graph API语义：直接透传 Microsoft Graph 端点，学习曲线平缓
3. 细粒度权限隔离：通过 ctrl.maton.ai 独立管理连接，支持多租户/多账号场景
4. 企业级数据覆盖：完整支持 SharePoint Online 的站点架构、内容类型、回收站机制
潜在缺点与局限性
- 文件大小限制：简单上传上限 4MB，大文件需分片上传会话（API文档未详述）
- 异步操作复杂度：Copy 等操作返回 202 Accepted，需轮询 Location 跟踪进度
- URL编码陷阱：Drive ID 中的
!必须编码为%21，易引发调试困难 - 权限依赖：部分管理操作需
Sites.FullControl.All等高权限授权 - 平台锁定：深度绑定 Maton 网关，迁移成本高于直接调用 Graph API
适合人群
- 需快速集成 SharePoint 的 SaaS 开发团队
- 希望规避 OAuth 实现细节的自动化运维工程师
- 构建企业文档管理、项目协作、数据同步工作流的产品经理
常规风险
- API Key 泄露：
MATON_API_KEY若硬编码至客户端或日志，可导致数据泄露 - 权限过度授予：OAuth 授权范围过大时，可能意外暴露敏感站点
- Rate Limiting：Microsoft Graph 默认限速 429，高频场景需实现指数退避
- 数据合规：跨境企业需注意 SharePoint 数据驻留与网关中转的合规性