SharePoint Online REST API如何通过POST请求体向/items端点传查询参数

可以实现，SharePoint REST API原生支持通过POST请求模拟GET操作的机制，可将查询参数放入请求体传递，完全兼容/items端点的所有特性。

实现原理 #

SharePoint 提供了HTTP方法重写机制，允许通过POST请求执行GET逻辑，以此规避GET请求的URL长度限制，同时完全保留/items端点的lookup、用户字段扩展能力，不受GetItems接口的约束。

具体实现步骤 #

1. 基础请求配置 #

• 请求地址：/_api/Web/Lists/getByTitle('ListName')/items（无需拼接任何查询参数）
• 请求方法：POST

2. 必要请求头 #

需要在请求中添加以下头信息：

Accept: application/json;odata=verbose
Content-Type: application/json;odata=verbose
X-HTTP-Method: GET
X-RequestDigest: <当前站点的请求防伪令牌>
Authorization: <和原有GET请求一致的认证信息>

注：X-RequestDigest可通过调用/_api/contextinfo接口POST请求获取，和常规SharePoint POST接口的获取逻辑一致

3. 请求体构造 #

将原本拼接在URL后的所有OData查询参数，按JSON格式放入请求体即可，参数语法和URL传递时完全一致。
示例：原URL查询参数为$select=Title,Author/Name,Department/Title&$expand=Author,Department&$filter=Status eq '生效'&$top=200，对应请求体为：

{
  "$select": "Title,Author/Name,Department/Title",
  "$expand": "Author,Department",
  "$filter": "Status eq '生效'",
  "$top": 200
}

注意事项 #

• 所有/items端点支持的OData查询参数（包括$select/$expand/$filter/$orderby/$top/$skip等）都可放入请求体，语法和URL传递时完全相同，无需额外调整
• 该方案没有GetItems接口的lookup/用户字段扩展限制，可正常实现多层字段扩展
• POST请求体的容量上限远高于GET请求的URL长度上限（一般可达几十MB），足以承载绝大多数复杂查询参数需求

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