最佳实践
让集成长久运行的做法。
- 用增量模式（desde + depoisDe）同步：只取变化部分，不会触及限制。
- 遇到 429 等待 Retry-After 并采用指数退避——切勿紧循环重试。
- 每个 POST 都带 Idempotency-Key：网络中断、例程重跑，也不会重复。
- 处理前验证 Webhook 签名；尽快返回 2xx，之后再处理。
- 每个集成系统一个密钥，范围最小够用；吊销不再使用的密钥。
不当做法
- 每分钟扫描整个列表——增量模式正是为取代它而存在。
- 把 API 密钥分享给最终用户，或嵌入移动应用或公开页面。
- 用没有负责人用户的密钥通过 API 写入——轨迹将没有作者，因此返回 409。