2022年SharePoint API选型：各API差异、支持状态及使用建议

先把最容易混淆的命名问题说清楚：你在资料里看到的REST v2（beta）不是独立于其他选项的新API，本质是早期预览阶段Microsoft Graph中SharePoint相关端点的旧称呼，官方从未正式发布过独立的SharePoint REST v2版本，当初规划划入REST v2的能力最终全部整合进了MS Graph。

当前实际可用的SharePoint API全清单 #

• .NET CSOM（客户端对象模型）：官方维护的.NET专属客户端封装库，分.NET Framework、.NET Core/.NET 5+两个维护分支，目前仍在持续迭代更新，屏蔽了底层HTTP请求、鉴权、请求格式处理的细节。
• JavaScript JSOM：CSOM的JavaScript版本，早年用于SharePoint页面嵌入脚本、早期版本SPFx开发，目前更新频率极低。
• SharePoint REST v1：即原生SharePoint REST接口，端点统一以{站点地址}/_api/为前缀，从SharePoint 2013版本开始上线，目前在SharePoint Online、SharePoint Server 2016/2019/订阅版所有可用版本中都支持。
• Microsoft Graph：微软365生态统一API入口，SharePoint相关端点为当前官方主推的云侧接口，正式版端点格式为https://graph.microsoft.com/v1.0/sites/[站点信息]，另有beta端点提供未正式发布的预览能力。
• 遗留SOAP接口：即SharePoint 2010及更早版本提供的*.asmx格式接口（比如Lists.asmx、Webs.asmx），仅做兼容保留。

值得重点投入研究的API #

结合你偏好REST类API的需求，按优先级排序：

1. Microsoft Graph
   如果你做的是SharePoint Online相关开发，这是首选REST类接口。它的鉴权逻辑和整个微软365生态（Teams、OneDrive、Outlook等）完全统一，不需要处理SharePoint传统接口里的请求摘要、上下文令牌这类历史包袱，所有新推出的SharePoint能力都会优先在Graph落地，长期维护保障性最强。常规开发中遇到少量Graph暂未覆盖的边缘能力，再临时搭配REST v1补位即可。
2. SharePoint REST v1
   两类场景下必选：一是你需要兼容SharePoint本地部署版本（2016/2019/订阅版），Graph对本地部署版本的支持非常有限；二是你需要用到的细分功能（比如部分细粒度列表项权限配置、小众服务端能力）Graph暂时没覆盖。这套接口是标准REST风格，稳定性极强，官方明确表态不会弃用，仅做安全和兼容性维护，不需要担心短时间内失效。
3. .NET CSOM
   如果你用.NET做服务端开发、或者写PowerShell脚本做站点运维/批量操作，CSOM的开发效率远高于手写REST请求，官方会同步跟进所有SharePoint Online的新能力，绝大多数REST接口没覆盖的边缘功能，CSOM都能支持。

完全不需要投入精力的弃用/过时API #

• 独立版本的SharePoint REST v2：从未正式发布，相关旧资料都是预览阶段的过时内容，不用浪费时间看。
• 所有SharePoint 2010时代的SOAP/ASMX接口：已经进入弃用流程，仅为老系统做兼容保留，新开发绝对不要用，云侧随时可能下线这类接口。
• JSOM（JavaScript客户端对象模型）：除了维护十年以上的遗留系统，新的SPFx开发官方已经推荐用Graph或REST v1，JSOM不会再新增任何功能，没必要专门学习。
• Silverlight版CSOM、Windows Phone专属SharePoint SDK这类早就停止维护的特定平台SDK，完全不用接触。

选型小提示：如果坚持用REST风格API，直接选「MS Graph为主、REST v1补位」的组合即可，这套组合能覆盖95%以上的常规SharePoint开发场景，包括站点配置、列表/文档库操作、权限管理、Web部件开发等，不需要额外引入重型客户端库依赖。

内容的提问来源于stack exchange，提问作者Aidal