HTTP Requestノードでは、APIの仕様に合わせてメソッド・URL・認証・本文を設定します。成功コードだけで判断せず、返ってきたデータの形と、取得した件数まで確認します。
API仕様の四項目を、ノードへ移す
最初に読み取り専用のエンドポイントを一つ選びます。APIドキュメントからHTTPメソッド、URL、認証方式、必須の入力を抜き出して設定してください。サンプルにあるURLやキーを、そのまま本番の認証値として使わないようにします。
| 仕様の項目 | 配置する場所 |
|---|---|
| 検索条件・取得期間 | Query Parameters。APIが指定する項目名に合わせる |
| 認証 | 対応するCredentials。手書きヘッダーが必要なら秘密の管理方法を決める |
| JSONの入力本文 | Body。JSONとフォームを取り違えない |
| 応答の型 | Response設定とOUTPUT。JSON・文字列・ファイルを区別する |
たとえばhttps://api.example.com/ordersへ注文IDで問い合わせる、という架空の設計なら、注文IDはAPIが求めるQueryへ置きます。認証トークンはURLへ含めず、ドキュメントの指定する方式で渡します。
一回の成功後に、空の結果とエラーを読む
取得結果が一件、0件、認証失敗の三つを確認します。0件は処理失敗とは限らず、条件に一致するデータがないだけの場合があります。エラーも、期限切れの認証とアクセス権限不足では対処が異なります。
試験記録の例
入力:存在する注文ID → 結果が一件
入力:存在しない注文ID → 空の結果の扱いを確認
認証:無効な試験用値 → 更新処理へ進まず停止
記録:HTTP状態・結果件数・失敗した実行ID
外部サービスへ何かを作成するPOSTの場合は、通信の失敗を見てすぐ再送しません。相手側では作成済みの可能性があり、先に結果IDや依頼IDで照合する必要があります。
ページ送りは、終了条件まで決める
HTTP Requestにはページ送りの設定がありますが、APIの方式は一つではありません。次ページURL、ページ番号、cursorなど、対象APIの仕様に合わせます。詳しい設定は公式HTTP Requestドキュメントで確認できます。
次ページがない、取得件数が0、処理上限へ達した、といった終了条件を用意します。同じcursorを繰り返していないかも記録すると、ページ送りが終わらない原因を追いやすくなります。
一度に増やすのは件数だけにする
一件の応答を読めたら数件に増やし、入力の対応とAPI上限を確認します。並列化、AI要約、外部更新を同時に追加すると、どこで件数が変わったか分かりにくくなります。
まず読み取りの入力と出力を保存し、その形式を後続へ渡す約束にします。待機や再試行はエラー処理の判断へ分け、認証値を除いた記録だけを残してください。