Adobe Experience PlatformのPostman
Postmanは、API 開発のコラボレーションプラットフォームで、プリセット変数の設定、API コレクションの共有、CRUD リクエストの効率化などを行うことができます。 ほとんどの Platform API サービスには、API 呼び出しの実行を支援するために使用できるPostman コレクションがあります。
Experience Platform用のPostman環境の設定方法
次のビデオガイドでは、Postman環境の作成とセットアップの概要を説明します。 Postman環境には、以下に提供される様々なコレクションに対する API 呼び出しを行うために必要なすべての必須ヘッダーが含まれています。 設定すると、値の有効期限(ACCESS_TOKEN
など)が切れるたびに、環境の現在の値を更新でき、この新しい値がすべてのコレクションで使用されます。
Postman コレクション collections
使用可能なすべてのPostman コレクションを含んだフォルダーは、Postman サンプル GitHub リポジトリのExperience Platform にアクセスすることで見つけることができます。 または、Postman コレクションリンクは、Adobe I/Oの API リファレンスドキュメントに記載されている個々の Swagger ファイルにあります。
Postman コレクションをダウンロードするには、GitHub ページの Raw を選択して、生の JSON ファイルを新しいタブに読み込みます。 次に、右クリックして「Save as」を選択し、選択したローカルの保存先にファイルを保存します。
Postman コレクションの読み込み import
Postman コレクションを利用するには、環境を設定する必要があります。 環境の設定が完了したら、右上隅の Manage Environments セレクターを選択します。
ポップオーバーが表示され、現在の環境がすべて表示されます。 コレクションを読み込むには、「import」を選択します。
読み込むファイルを選択するよう求められます。 読み込むPostman コレクションファイルを選択します。 選択すると、コレクションが「コレクション」タブの左パネルに表示されます。
各コレクションには、CRUD 操作を正常に実行するために必要になる可能性のある異なるキーと値のペアがあります。 必要な値、ヒント、例については、サービスの API 開発者ガイドを参照してください。
Postman UI と使用可能な機能について詳しくは、Postman ドキュメントを参照してください。
実稼動以外で使用するためのPostmanによるアクセストークンの生成
以下のビデオでは、Identity Management サービス(IMS)のPostman コレクションを使用しています。このコレクションは公開されている GitHub リポジトリからダウンロードできます。
次の手順
このドキュメントでは、Postman環境、コレクションおよびコレクションの読み込み方法を紹介しました。 Postmanの準備が整ったら、Platform 入門ガイドにアクセスして、必要なヘッダー、例、各 Platform サービスで使用できる API ガイドのリストを確認します。