HTTP リクエスト

OpenAPI 文書や Connector の Action を使わず、HTTP エンドポイントを呼び出します。

HTTP Request は単一の HTTP(S) 呼び出しに使います。ポートの生成、パラメーターのエンコード、応答の解析を担当します。

リクエストを設定する

業務設定で、メソッド、クエリ・ヘッダーモード、認証、ボディ形式、応答形式、ステータスポリシーを選びます。URL やリクエスト値は、固定値も含めて inputs に指定します。

{
  "op": "node.add", "as": "request", "type": "http-request", "name": "Read service status",
  "config": { "method": "GET", "responseFormat": "json", "statusPolicy": "success" },
  "inputs": { "url": { "kind": "value", "value": "https://api.example.com/status" } }
}

実行前に実際の URL に置き換えます。項目別のクエリやヘッダーでは、グループの名前を設定して query.NAME または header.NAME をバインドします。オブジェクト全体のモードでは query または headers を使います。

HTTP Request が 1 回の GET を送り、body、statusCode、headers を返します。

認証

Bearer、Basic、API キーなど、提示された認証方式に対応します。認証情報の入力元には変数や上流出力を使い、固定の認証情報は直接指定できません。Bearer は auth.token、Basic は auth.username と auth.password を使います。

認証は方式全体を置換します。パラメーターモードを変更すると、編集仕様に従って設定名を保持しながら、削除されたポートのバインドを解除します。

結果

出力は常に body、statusCode、headers です。JSON 配列も 1 つの body 値になります。エンドポイントに合わせて自動、JSON、テキストの解析を選びます。

デフォルトでは 2xx 以外を失敗とします。非成功応答を下流の Condition で確認するなら statusPolicy: "all" を使います。ネットワークや解析の失敗は引き続きエラーです。

エラー処理

通常の再試行と onError に対応します。専用のエラー実行エッジはありません。書き込みを再試行すると外部で操作が重複する場合があるため、エンドポイントの動作に合わせて設定してください。

HTTP リクエスト

リクエストを設定する

認証

結果

エラー処理

参照元