调用8x8 API分页异常：X-Total-Pages显示38页但page=10报错

问题详情 #

调用8x8 Analytics CC API获取历史指标数据时遇到分页异常：

• 请求第9页时，响应头返回：X-Page: 9，X-Total-Pages: 38，X-Total-Elements: 37463，请求URL：

  https://api.8x8.com/analytics/cc/v5/historical-metrics/3511365/data?page=9&size=1000
  

• 但将page参数改为10后，立即收到错误：

  Bad request: Field 'page' must be greater than or equal to 0 and less than the total number of pages, which is 0 for this request
  

按响应头的总页数计算，应该有38页数据可获取，但实际请求第10页就触发错误，且无相关案例参考。

排查方向 #

• 校验分页索引规则：部分API分页从0开始计数，尝试将page=9改为page=8、page=10改为page=9，测试是否能正常返回数据。
• 确保请求参数一致：检查请求第10页时的认证信息、筛选条件、时区等参数是否和第9页完全相同，避免隐式参数变化导致API重新计算分页逻辑。
• 缩小单页数据量：虽然设置了size=1000，但API可能存在未公开的单页上限，尝试将size改为500或更小，再请求第10页。
• 排查实时数据同步问题：8x8 API的分页统计可能基于实时数据，尝试等待一段时间后重新请求，或更换时间段测试。
• 确认API版本状态：查看v5版本的官方文档更新日志，确认是否存在已知的分页bug。

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