如何使用Shippingbo API获取preparation run列表？

调用https://app.shippingbo.com/preparation_runs返回500错误时，可尝试以下几种替代方案：

1. 带分页/过滤参数调用列表接口 #

500错误大概率是因为未做限制的请求返回数据量过大导致服务端崩溃。尝试添加分页和过滤参数缩小数据集：

• 分页参数：使用page和per_page控制返回条数，示例请求：

  GET https://app.shippingbo.com/preparation_runs?page=1&per_page=20
  

• 时间过滤：如果API支持，通过created_at_min/created_at_max限定时间范围，进一步减少返回数据：

  GET https://app.shippingbo.com/preparation_runs?created_at_min=2024-01-01T00:00:00Z&created_at_max=2024-01-31T23:59:59Z&page=1&per_page=20
  

2. 配置Webhook实时接收数据 #

在ShippingBo后台配置Webhook，设置当preparation run创建或更新时，自动推送完整数据到你的系统接口。这种方式无需主动调用列表接口，还能实时获取最新数据。

3. 联系官方技术支持 #

提交工单给ShippingBo技术团队，提供请求的完整上下文（请求头、参数、错误响应截图/日志），要求排查500错误的原因，或者申请批量获取的专属接口权限。

4. 批量查询单个资源（临时应急方案） #

如果以上方法都无法快速生效，可从现有业务数据中提取已知的preparation run ID（比如关联订单的记录），然后循环调用单个资源接口https://app.shippingbo.com/preparation_runs/{preparation_run_id}/packing_slip_information批量获取数据。注意控制请求频率，避免触发限流机制。

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