カスタムAPI呼び出し

このピースでできること

  • マネーフォワード クラウド債務支払の任意のAPIエンドポイントに対してカスタムAPIリクエストを実行します。
  • 標準アクションでは対応していないAPI操作を実行する際に利用します。
  • 認証ヘッダーは接続情報から自動的に付与されます。

マネーフォワード クラウド債務支払 の接続方法

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

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

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

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

  1. マネーフォワード クラウドにログイン後、画面右上のユーザーメニューから 「個人設定」 を開きます。
  1. 「基本設定」「API連携はこちら」 をクリックします。
  1. 「アプリケーション」 を新規登録します。
  1. 「コールバック URL(https のみ)」 に、ステップ 1 でコピーしたリダイレクト URL を入力します。
  1. 以下のスコープにチェックを入れます。
      • (事業者の設定から、事業者の従業員の設定まで管理できる権限)
      • (ユーザー自身の設定を管理できる権限)
      • (明細の読み書きができる権限)
      • (申請の読み書きができる権限)
      • (連携サービスの管理が出来る権限)
      • (公開リソースを読み込む権限)
      • ※「カスタム API 呼び出し」アクションで他の API を使用する場合は、対応するスコープも追加してください
  1. 「Confidential」 にチェックを入れてアプリケーションを作成します。
  1. 作成後に表示される クライアント ID(アプリケーションID)クライアントシークレット(シークレット) をコピーしておきます。

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

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

ピースの設定項目

1. URL(必須)

  • リクエスト先のURLを入力します。完全なURLまたはベースURL()からの相対パスどちらでも指定できます。

2. メソッド(必須)

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

3. ヘッダー(任意)

  • 追加のリクエストヘッダーをJSON形式で入力します。認証ヘッダーは接続情報から自動的に付与されます。

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

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

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

  • リクエストボディの形式を選択します。選択肢: なし / JSON / フォームデータ

6. ボディ(任意)

  • リクエストボディをJSON形式で入力します。POST / PUT / PATCH リクエスト時に使用します。

7. 応答はバイナリですか?(任意)

  • PDF・画像などバイナリレスポンスを受け取る場合に有効にします。

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

  • APIがエラーを返してもフローを継続させたい場合に有効にします。

9. タイムアウト(秒)(任意)

  • リクエストのタイムアウト秒数を指定します。

10. リダイレクトをフォローする(任意)

  • HTTPリダイレクトを自動的にフォローする場合に有効にします。