API トークン認証を使用する web サービスに Adobe Workfront Fusion を接続

最終更新日： 2025年3月14日
  • トピック：

一部のサービスでは、Adobe Workfront Fusion などの統合ソリューションを使用して、シナリオで簡単に使用できるアプリを作成できません。

この状況の回避策は、HTTP / リクエストを行うモジュールを使用して、目的のサービス（アプリ）をWorkfront Fusion に接続することです。

この記事では、API キー/API トークンを使用して、ほぼすべての web サービスをWorkfront Fusion に接続する方法について説明します。

アクセス要件

展開すると、この記事の機能のアクセス要件が表示されます。

この記事で説明している機能を使用するには、次のアクセス権が必要です。

Adobe Workfront パッケージ任意
Adobe Workfront プラン

新規：標準

または

現在：ワーク以上

Adobe Workfront Fusion ライセンス**

現在：Workfront Fusion ライセンス要件なし

または

レガシー：任意

製品

新規：

  • Prime Workfront プランを選択する：組織がAdobe Workfront Fusion を購入する必要があります。
  • Ultimate Workfront プラン：Workfront Fusion が含まれています。

または

現在：Adobe Workfront Fusion を購入する必要があります。

このテーブルの情報について詳しくは、 ドキュメントのアクセス要件を参照してください。

Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。

API トークンを使用する web サービスへの接続

API トークンを介してサービスに接続する手順は、ほとんどの web サービスで同様です。

  1. Web サービスの web サイト上にアプリケーションを作成します。詳しくは、この記事の新しいアプリケーションを作成して API トークンを取得を参照してください。
  2. API キーまたは API トークンを取得します。
  3. シナリオにWorkfront Fusion の HTTP / リクエストを行うモジュールを追加します。
  4. この記事の HTTP モジュールの設定の節で説明されているように、web サービスの API ドキュメントに従ってモジュールを設定し、シナリオを実行します。
NOTE
次の使用例は、Pushhover 通知サービスに接続します。

新しいアプリケーションを作成して API トークンを取得

NOTE
Web サービスで API キーまたは API トークンを作成および配布するには、多くの異なる方法があります。目的の web サービスの API キーとトークンの取得手順については、サービスの web サイトにアクセスし、「API キー」または「API トークン」を検索してください。
Pushover API キーを取得する手順は、検索対象の例として記載しているだけです。
  1. Pushhover アカウントにログインします。
  2. ページの下部にある「Create an Application/API Token」をクリックします。
  3. アプリケーション情報を入力し、「Create an Application」をクリックします。
  4. 提供された API トークンを安全な場所に保存します。目的の web サービスに接続するには、Workfront Fusion HTTP / リクエストを行うモジュール（この場合は Pushhover）が必要です。

HTTP モジュールの設定

Web サービスをWorkfront Fusion シナリオに接続するには、シナリオで HTTP/リクエストを行うモジュールを使用し、web サービスの API ドキュメントに従ってモジュールを設定する必要があります。

  1. シナリオに HTTP / リクエストを行うモジュールを追加します。

  2. Workfront Fusion を使用してメッセージをプッシュするには、HTTP モジュールを次のように設定します。

    NOTE
    これらのモジュール設定は、Pushhover web サービス API ドキュメントに対応しています。 他の web サービスでは設定が異なる場合があります。例えば、API トークンは Body フィールドではなく Header に挿入できます。
    URL

    https://api.pushover.net/1/messages.json

    URL フィールドには、web サービスの API ドキュメントで確認できるエンドポイントが含まれます。

    メソッド

    POST

    使用されるメソッドは、対応するエンドポイントによって異なります。メッセージをプッシュするための Pushover エンドポイントでは、POST メソッドを使用します。

    ヘッダー一部の web サービスでは、ヘッダーを使用して API トークン認証や他のパラメーターを指定します。メッセージをプッシュする際、Pushover エンドポイントはすべてのリクエストタイプで本文を使用するので、この例ではそうではありません（以下を参照）。
    クエリ文字列一部の web サービスでは、クエリ文字列を使用して他のパラメーターを指定します。Pushhover web サービスは、すべてのリクエストタイプに対して Body （以下を参照）を使用するので、この例では該当しません。
    本文タイプ

    Raw

    この設定を使用すると、下の「コンテンツタイプ」フィールドで JSON コンテンツタイプを選択できます。

    コンテンツタイプ

    JSON (application/json)

    JSON は、Pushover アプリで必要なコンテンツタイプです。 これは、他の web サービスとは異なる場合があります。

    コンテンツをリクエスト

    Body リクエストのコンテンツを JSON 形式で入力します。 この記事の JSON を使用した JSON 本文のマッピング/JSON モジュールの作成で説明しているように、JSON/JSON モジュールを作成を使用できます。 または、この記事の JSON 本文の手動入力で説明しているように、JSON コンテンツを手動で入力できます。

    その web サービスに必要なパラメーターについて詳しくは、web サービスの API ドキュメントを参照してください。