カスタムAPI呼び出し
このピースでできることマネーフォワード クラウド債務支払 の接続方法ステップ 1:workrun のリダイレクト URL を確認するステップ 2:マネーフォワード クラウドで OAuth クライアントを作成するステップ 3:workrun に接続を追加するピースの設定項目1. URL(必須)2. メソッド(必須)3. ヘッダー(任意)4. クエリパラメータ(任意)5. ボディタイプ(任意)6. ボディ(任意)7. 応答はバイナリですか?(任意)8. 失敗時にエラーにしない(任意)9. タイムアウト(秒)(任意)10. リダイレクトをフォローする(任意)
このピースでできること
- マネーフォワード クラウド債務支払の任意のAPIエンドポイントに対してカスタムAPIリクエストを実行します。
- 標準アクションでは対応していないAPI操作を実行する際に利用します。
- 認証ヘッダーは接続情報から自動的に付与されます。
マネーフォワード クラウド債務支払 の接続方法
workrun と マネーフォワード クラウド債務支払 を接続するには、マネーフォワード クラウド債務支払 の OAuth クライアント(クライアントID・クライアントシークレット) が必要です。
ステップ 1:workrun のリダイレクト URL を確認する
- workrun で マネーフォワード クラウド債務支払 のアクションをフローに追加します。
- 「接続を選択」の横にある 「+ 新しい接続」 をクリックします。
- 接続画面に表示される 「リダイレクト URL」 をコピーしておきます。
ステップ 2:マネーフォワード クラウドで OAuth クライアントを作成する
- マネーフォワード クラウドにログイン後、画面右上のユーザーメニューから 「個人設定」 を開きます。
- 「基本設定」 → 「API連携はこちら」 をクリックします。
- 「アプリケーション」 を新規登録します。
- 「コールバック URL(https のみ)」 に、ステップ 1 でコピーしたリダイレクト URL を入力します。
- 以下のスコープにチェックを入れます。
- (事業者の設定から、事業者の従業員の設定まで管理できる権限)
- (ユーザー自身の設定を管理できる権限)
- (明細の読み書きができる権限)
- (申請の読み書きができる権限)
- (連携サービスの管理が出来る権限)
- (公開リソースを読み込む権限)
- ※「カスタム API 呼び出し」アクションで他の API を使用する場合は、対応するスコープも追加してください
- 「Confidential」 にチェックを入れてアプリケーションを作成します。
- 作成後に表示される クライアント ID(アプリケーションID) と クライアントシークレット(シークレット) をコピーしておきます。
ステップ 3:workrun に接続を追加する
- ステップ 1 の接続画面に戻り、「クライアントID」 フィールドにクライアント ID を貼り付けます。
- 「クライアントシークレット」 フィールドにクライアントシークレットを貼り付けます。
- 「接続」 をクリックすると、マネーフォワードの認証画面が開きます。
- マネーフォワード クラウドにログインし、workrun に対するアクセスを 「許可」 します。
- 画面が自動で閉じ、接続が完了します。
ピースの設定項目
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リダイレクトを自動的にフォローする場合に有効にします。