web api をcall

アクションの場所:Utility > データ > web api をcall

 

外部のweb apiを実行することができます。

Tips
デフォルトではContent-Type: application/jsonがheadersパラメータに指定されます。
PUT/POSTなどの場合、相手先の仕様によってはContent-Type: application/x-www-form-urlencodedをheadersパラメータに指定して下さい。但しその場合もapiパラメータはJSON形式で指定する必要があります。

設定方法(簡単)

1web api をcall.png

① 「Utility/データ」カテゴリにある「web api をcall」アクションをクリックします。

② api url:api urlを指定します。

設定方法(便利)

③ api url 参照設定:テキストタイプのアクション結果を参照し、設定します。

④ api パラメータ(任意):apiパラメータをDictionary型(JSON)で指定します。File型を返す他アクションを部分参照した場合、base64化された値が送信されます。

⑤ api パラメータ 参照設定(任意):ディクショナリータイプのアクション結果を参照し、設定します。

⑥ metod(任意):http methodタイプを選択します。

⑦ headers(任意):http headerをDictionary型(JSON)で指定します。

⑧ headers 参照設定(任意):ディクショナリータイプのアクション結果を参照し、設定します。

Tips
シナリオ実行後、アクションをクリックすると、戻り値に格納されるstatusコードを確認することができます。
正常にアクションが完了すると、実行結果に"status":"200"が表示されます。エラーが発生した場合は、エラーコードが表示されます。

■正常にアクションが完了した場合の実行結果2web api をcall.png

オプション設定

以下の設定項目は任意です。

⑨ 安全な接続ではないURLにアクセスする:「はい」にすることでサーバーのSSL証明書が自己証明書や有効期限が切れているようなサイトにアクセスできます。

エラーを無視

 

アクション使用例

◆Gemini API を call し、結果を取得するシナリオを作成します。

<全体図>

「web api を call」→「キーを指定して要素を取得」

<各アクション詳細>

・web api を call

api url:Google Gemini にアクセスするため、以下のように入力します。

https://generativelanguage.googleapis.com/v1/models/gemini-2.5-flash:generateContent


api パラメータ:ボディの内容をjson形式で以下のように入力します。

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
         "text": "GoogleGeminiにできることを一文で教えて"
        }
      ]
    }
  ]
}

method:「POST」を選択します。

headers:ヘッダーを json 形式で以下のように入力します。"KEY"には任意のシークレット値を登録するから登録した自身のAPIキーを部分参照します。

{"Content-Type": "application/json", "x-goog-api-key":"KEY"}
・キーを指定して要素を取得

入力データ:「web api を call」を参照します。

キー:Geminiの場合「body.candidates[0].content.parts[0].text」と指定することで、結果から出力部分を抽出することができます。

 

コメント

0件のコメント

サインインしてコメントを残してください。