この Edge Network Server API は、イベントのソースと API 収集ドメインに応じて、認証済みと未認証の両方のデータ収集を処理します。
リクエストごとに、 Server API データストリームを検証します。 access type 設定。 この設定を使用すると、お客様は認証済みデータを受け入れるか、認証済みデータと未認証データの両方を受け入れるようにデータストリームを設定できます。 デフォルトでは、両方のタイプのデータが受け入れられます。
データストリームアクセスタイプの設定について詳しくは、 データストリームの作成と設定.
以下に、データストリームに基づく動作の概要を示します Access Type 設定およびリクエストを受信したエンドポイント。
Access Type | edge.adobedc.net | server.adobedc.net |
---|---|---|
mixed (デフォルト) | リクエストを認証しません | 要求を認証します |
認証済み | 要求を認証します | 要求を認証します |
のプライベートサーバーからの API 呼び出し server.adobedc.net
は常に認証される必要があります。
を呼び出す前に、 Server APIを使用する場合は、次の前提条件を満たしていることを確認します。
developer
および user
役割がAdobe Experience Platform API 製品プロファイルで有効になっていること お問い合わせ Admin Console 管理者:アカウントに対してこれらのロールを有効にします。Platform API への呼び出しを実行する前に、認証に関するチュートリアルを完了する必要があります。認証に関するチュートリアルを完了すると、すべての Experience Platform API 呼び出しで使用する、以下のような各必須ヘッダーの値が提供されます。
{ACCESS_TOKEN}
{API_KEY}
{ORG_ID}
Experience Platform のリソースは、特定の仮想サンドボックスに分離することができます。Platform API へのリクエストでは、操作を実行するサンドボックスの名前と ID を指定できます。次に、オプションのパラメーターを示します。
{SANDBOX_NAME}
Experience Platform のサンドボックスについて詳しくは、サンドボックスの概要ドキュメ ントを参照してください。
ペイロード(POST、PUT、PATCH)を含むすべてのリクエストには、メディアのタイプを指定する以下のような追加ヘッダーが必要です。
application/json
データセットの書き込み権限を設定するには、 Admin Consoleで、API キーに関連付けられている製品プロファイルを探し、次の権限を設定します。
エラーコード | エラーメッセージ | 説明 |
---|---|---|
EXEG-0500-401 |
無効な認証トークン | このエラーメッセージは、次のいずれかの状況で表示されます。
|
EXEG-0501-401 |
無効なユーザー認証トークン | このエラーメッセージは、次のいずれかの状況で表示されます。
|
EXEG-0502-401 |
無効な認証トークン | このエラーメッセージは、指定された認証トークンの形式 (JWT) が有効で、署名が無効な場合に表示されます。 次を確認します。 認証チュートリアル 有効な JWT トークンの取得方法を参照してください。 |
EXEG-0503-401 |
無効な認証トークン | このエラーメッセージは、指定された認証トークンの有効期限が切れると表示されます。 詳しくは、 認証チュートリアル をクリックして新しいトークンを生成します。 |
EXEG-0504-401 |
必要な製品コンテキストがありません | このエラーメッセージは、次のいずれかの状況で表示されます。
|
EXEG-0505-401 |
必要な認証トークンスコープがありません | このエラーは、サービスアカウント認証にのみ適用されます。 このエラーメッセージは、呼び出しに含まれるサービス認証トークンが、 acp.foundation IMS スコープ。 |
EXEG-0506-401 |
書き込み用のサンドボックスにアクセスできません | このエラーメッセージは、開発者アカウントに WRITE datastream が定義されているExperience Platformサンドボックスへのアクセス |