429/5xxに粘るAPI連携ハーネス

件数が合わなければ通知が来る

外部APIからデータを取得する処理を、エラーを握りつぶさない・勝手に諦めない・取りこぼしを黙認しない形に固める土台ワークフローです。
相談も打ち合わせも不要、購入後すぐ使用できます。

n8nコミュニティのフォーラムを152件調べたところ、HTTP Requestの403/401・Cloudflare・ページネーション絡みの事故が15件ありました。
ページネーション中のエラーが握りつぶされる、429/5xxで即死する、途中ページの失敗に気づかず欠損集計になる、といった事故が典型です。

差し込み例:

• Before: 毎朝手でCSVをダウンロードする

• After: 毎朝勝手に取得済みになっている

• Before: 途中ページで失敗しても気づかず欠損集計になる

• After: 件数が合わなければ通知が来る

【壊れない設計】

HTTPノードのエラー判定に頼らず、ステータスコードを自前検査します。
429/5xxは指数バックオフで自動リトライし、4xx(認証・権限エラー)はリトライせず即アラートにします。

取得件数を期待値と突合し、200成功でも空配列なら失敗扱いにする0件ガードも入れています。

【この商品の割り切り】

お客様の環境には入りません。
APIキー・パスワードもお預かりしません。
手順書とワークフロー定義をまとめた1つのテキストをお渡しするだけです。

導入作業はお客様自身で行っていただきます。
導入に関する質問はメッセージで3回まで対応します。

【納品物】

・ワークフローファイル(ハードン化ページネーション取得、json形式・中身はn8n標準のワークフロー定義)

・導入手順書(接続先設定・リトライ上限設定・動作確認手順)

【検証状況】

実機で5経路のテスト(正常取得・件数不一致検知・タイムアウト・5xxバックオフ・0件ガード)に合格済みです。