接收订单：API 轮询或通知

选择一种方式：API 通知（推荐）或定期轮询 Partner API。

方式 1. API 通知

• 启用接收 POST notification。如何使用通知：指南
• 接收订单事件并立即获取详情：GET v2/campaigns/{campaignId}/orders/{orderId}
• 通知类型与数据格式：POST notification

方式 2. 定期轮询 API

• 请求订单列表：
  • GET v2/campaigns/{campaignId}/orders
  • POST v1/businesses/{businessId}/orders
• 使用筛选：
  • fromDate 和 toDate — 用于新订单的配送日期范围
  • updatedAtFrom 和 updatedAtTo — 有变更的订单
• 轮询间隔：
  • Express — 每 10–15 分钟
  • FBS、DBS — 至少每小时一次
• 对每个找到的订单获取详情：GET v2/campaigns/{campaignId}/orders/{orderId}

如何选择

• 实时性优先时，选择 API 通知。请确保能接收 POST notification、实现幂等处理、保存事件时间（createdAt/updatedAt）、并正确处理重复
• 作为兜底，增加轮询，用于通知不可用或极少数不同步的情况。建议每 15–30 分钟轮询一次，并在你方发生故障后强制轮询
• 进行轮询时，限制时间窗口（fromDate/toDate），并使用 updatedAtFrom/updatedAtTo 做增量获取；遵守限流，并在错误时使用指数退避
• 为更高可靠性，组合使用：通知 + 后台轮询。持久化检查点（如最大 updatedAt），并对延迟/错误增长设置告警