You need to enable JavaScript to run this app. 如何使用Microsoft Graph API获取完整响应或正确设置分页?
优惠活动
大模型
产品
解决方案
定价
更多

如何使用Microsoft Graph API获取完整响应或正确设置分页?

Microsoft Graph DriveItem children 接口限制与全量获取方案

已知接口硬规则

  • 针对目标请求地址 https://graph.microsoft.com/v1.0/sites/{site-id}/drive/items/{folder-id}/children,服务端默认单页返回上限约为1200条,你观察到的仅返回1206条结果,是接口默认分页阈值触发的正常行为,并非数据丢失。
  • 该资源从设计层面完全不支持$skip偏移查询参数,手动附加$skip=xxx参数会直接触发服务端400类错误,提示参数不被当前资源支持,和你实际遇到的报错表现一致。
  • 此前使用$top参数未达预期的原因是:该端点的$top参数合法取值上限为200,如果你设置的$top值超过200,服务端不会按照你设定的数值返回,只会截断到允许的单页最大阈值,无法突破服务端的分页硬限制。

正确的全量分页实现逻辑

该接口采用服务端游标分页,而非传统的偏移分页,不需要手动计算跳过的条目数,操作流程为:

  1. 发起初始请求获取第一页结果,响应体除了条目列表外,会自动携带@odata.nextLink字段,这个字段的完整值就是下一页的合法请求地址,内部包含服务端生成的分页游标($skiptoken参数)。
  2. 后续分页请求直接原封不动使用上一次响应返回的@odata.nextLink地址发起请求即可,无需手动拼接任何查询参数。
  3. 重复上述请求流程,直到某次响应中不再出现@odata.nextLink字段,即代表已经获取到目标文件夹下的全部children资源。

实操注意事项

  • 如需主动控制单页返回条目数,可在初始请求中附加$top参数,取值范围为1-200之间的整数,后续自动生成的@odata.nextLink会自动保留该参数值,保证分页过程中单页大小一致,不会中断数据连续性。
  • 不要手动修改@odata.nextLink内部的$skiptoken游标值,也不要自行删除、替换游标参数,否则会直接触发接口报错。

内容的提问来源于stack exchange,提问作者hotcakedev

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.13 11:36:03