カスタムAPI呼び出し

このピースでできること

  • マネーフォワード クラウド請求書の任意のAPIエンドポイントに対してカスタムHTTPリクエストを送信できます。
  • 標準アクションにない操作や細かなパラメータの調整など、自由なエンドポイントでAPIを呼び出せます。

マネーフォワード クラウド請求書 の接続方法

workrun とマネーフォワード クラウド請求書 を接続するには、マネーフォワード クラウド請求書 の OAuth クライアント(クライアントID・クライアントシークレット) が必要です。

ステップ 1:workrun のリダイレクト URL を確認する

  1. workrun でマネーフォワード クラウド請求書 のアクションをフローに追加します。
  1. 「接続を選択」の横にある 「+ 新しい接続」 をクリックします。
  1. 接続画面に表示される 「リダイレクト URL」 をコピーしておきます。

ステップ 2:マネーフォワード クラウド請求書 で OAuth クライアントを作成する

  1. マネーフォワード クラウド アプリポータル で新しいアプリケーションを登録します。
  1. コールバックURL に、ステップ 1 でコピーしたリダイレクト URL を設定します。
  1. クライアント認証方式を 「CLIENT_SECRET_POST」 に指定します。
  1. 登録後に表示される クライアントIDクライアントシークレット をコピーしておきます。
      • 必要な認可スコープ: (請求書データの読み取り)、(請求書データの書き込み)

ステップ 3:workrun に接続を追加する

  1. ステップ 1 の接続画面に戻り、クライアントIDクライアントシークレット をそれぞれ貼り付けます。
  1. 「接続」 をクリックすると、マネーフォワード クラウド請求書 の認証画面が開きます。
  1. マネーフォワード クラウド請求書 にログインし、workrun に対するアクセスを 「許可」 します。
  1. 画面が自動で閉じ、接続が完了します。

ピースの設定項目

1. URL(必須)

  • 呼び出すAPIのURLを入力します。完全なURLまたはベースURL()からの相対パスを指定できます。

2. メソッド(必須)

  • HTTPメソッドを選択します。GET・ POST・ PUT・ PATCH・ DELETE などから選べます。

3. ヘッダー(任意)

  • 追加のHTTPヘッダーをJSON形式で入力します。認証ヘッダー(Authorization)は接続情報から自動で注入されます。

4. クエリパラメータ(任意)

  • URLに付加するクエリパラメータをJSON形式で入力します。

5. ボディタイプ(任意)

  • リクエストボディの種別を選択します。JSON・ Raw・フォームデータ・なしから選びます。

6. ボディ(任意)

  • リクエストボディを選択したボディタイプに合わせた形式で入力します。

7. 失敗時にエラーにしない(任意)

  • 有効にするとHTTPエラーレスポンス(ステータスコード4xx・5xx)の場合もフローを継続します。