Adobe Experience PlatformのPostman

Postmanは、事前設定された変数を使用した環境の設定、API コレクションの共有、CRUD リクエストの合理化などを可能にするAPI開発向けのコラボレーションプラットフォームです。 ほとんどのExperience Platform API サービスには、API呼び出しの実行を支援するために使用できるPostman コレクションがあります。

Experience Platform用のPostman環境の設定方法

次のビデオガイドでは、Postman環境の作成と設定の概要を説明します。 Postman環境には、以下に示す様々なコレクションに対するAPI呼び出しを行うために必要なすべてのヘッダーが含まれています。 設定が完了すると、値の有効期限(ACCESS_TOKENなど)が切れるときはいつでも環境内の現在の値を更新でき、この新しい値はすべてのコレクションで使用されます。

Postman コレクション collections

使用可能なすべてのPostman コレクションを含むフォルダーは、Experience Platform Postman サンプル GitHub リポジトリ ​を参照して見つけることができます。 または、Postman コレクションのリンクは、Adobe I/OのAPI リファレンスドキュメント ​の各swagger ファイルにあります。

Postman コレクションをダウンロードするには、GitHub ページから​ Raw ​を選択して、生のJSON ファイルを新しいタブに読み込みます。 次に、右クリックして「Save as」を選択し、選択したローカルの保存先にファイルを保存します。

生のJSON

Postman コレクションの読み込み import

Postman コレクション ​を利用するには、環境を設定する必要があります。 環境の設定が完了したら、右上隅の​Manage Environments セレクターを選択します。

環境セレクターの管理

ポップオーバーが表示され、現在のすべての環境が表示されます。 コレクションを読み込むには、「import」を選択します。

​ ボタンの読み込み

読み込むファイルを選択するように求められます。 読み込むPostman コレクションファイルを選択します。 選択すると、「コレクション」タブの左側のパネルにコレクションが表示されます。

​ コレクションが入力されました

各コレクションには、CRUD操作を成功させるために必要なキーと値のペアが異なります。 サービスのAPI開発者ガイド ​を確認して、必要な値、ヒント、および例を確認してください。

Postman UIとその利用可能な機能について詳しくは、Postman ドキュメント ​を参照してください。

Postmanを使用してアクセストークンを生成し、実稼動以外で使用する

WARNING
Identity Management Service (IMS) Postman コレクションに記載されているように、表記された生成方式は​ 実稼動以外の使用 ​に適しています。 ローカル署名は、サードパーティホストからJavaScript ライブラリを読み込み、リモート署名は、Adobeが所有および操作するweb サービスに秘密鍵を送信します。 Adobeはこの秘密鍵を保存しませんが、実稼動キーは誰にも共有しないでください。

以下のビデオでは、パブリック GitHub リポジトリからダウンロードできるIdentity Management Service (IMS) Postman コレクション ​を使用しています。

次の手順

このドキュメントでは、Postman環境、コレクション、およびコレクションの読み込み方法について説明しました。 Postmanの準備が整ったので、Experience Platform入門ガイド ​にアクセスして、必要なヘッダー、例、各Experience Platform サービスで利用できるAPI ガイド ​の一覧を確認してください。

recommendation-more-help
experience-platform-help-landing