ベストプラクティス
連携を長持ちさせるもの。
- 同期には増分モード（desde + depoisDe）を使う：変更分だけ取得し、制限に当たりません。
- 429はRetry-Afterを待ち、指数バックオフで対処する — 短いループで再試行しない。
- すべてのPOSTにIdempotency-Keyを送る：ネットワーク断でルーチンが再実行されても重複しません。
- 処理前にWebhookの署名を検証する。すばやく2xxを返し、処理は後で。
- 連携システムごとに1つのキーを最小スコープで。使わないキーは失効。
不適切なやり方
- 毎分一覧全体を走査する — まさに増分モードが置き換えるものです。
- APIキーをエンドユーザーと共有したり、モバイルアプリや公開ページに埋め込んだりする。
- キーに責任ユーザーなしでAPI経由で書き込む — 履歴に作成者が残らないため409になります。