驗證 authentication
概觀
Edge Network Server API會根據事件來源和API收集網域來處理已驗證和未驗證的資料收集。
針對每個要求，Server API會驗證資料流access type設定。 使用此設定，客戶可以設定資料串流以接受已驗證的資料，或同時接受已驗證和未驗證的資料。 預設情況下，接受兩種型別的資料。
如需有關設定資料流存取型別的詳細資訊，請參閱有關如何建立和設定資料流的檔案。
以下是根據資料流Access Type設定和收到要求的端點之行為摘要。
Access Type
edge.adobedc.net
server.adobedc.net
混合（預設）
不驗證請求
驗證請求
已驗證
驗證請求
驗證請求
來自server.adobedc.net上私人伺服器的API呼叫一律應經過驗證。
先決條件 prerequisites
呼叫Server API之前，請確定您符合下列必要條件：
- 您擁有可存取Adobe Experience Platform的組織帳戶。
- 您的Experience Platform帳戶已針對Adobe Experience Platform API產品設定檔啟用
developer和user角色。 請連絡您的Admin Console管理員，為您的帳戶啟用這些角色。 - 您有Adobe ID。 如果您沒有Adobe ID，請前往Adobe Developer Console並建立新帳戶。
收集認證 credentials
若要呼叫Platform API，您必須先完成驗證教學課程。 完成驗證教學課程，在所有Experience Platform API呼叫中提供每個必要標題的值，如下所示：
- 授權：持有人
{ACCESS_TOKEN} - x-api-key：
{API_KEY} - x-gw-ims-org-id：
{ORG_ID}
Experience Platform中的資源可以隔離到特定的虛擬沙箱。 在對Platform API的請求中，您可以指定將執行作業的沙箱名稱和ID。 這些是選用引數。
- x-sandbox-name：
{SANDBOX_NAME}
NOTE
如需Experience Platform中沙箱的詳細資訊，請參閱沙箱概觀檔案。
包含裝載(POST、PUT、PATCH)的所有請求都需要額外的媒體型別標頭：
- Content-Type：
application/json
設定資料集寫入許可權 dataset-write-permissions
若要設定資料集寫入許可權，請移至Admin Console，找出附加至API金鑰的產品設定檔，並設定下列許可權：
- 在沙箱區段中，選取資料流沙箱。
- 在資料管理區段中，選取 管理資料集 許可權。
疑難排解授權錯誤 troubleshooting-authorization
錯誤代碼
錯誤訊息
說明
EXEG-0500-401授權權杖無效
此錯誤訊息會在下列任一情況下顯示：
- 缺少
authorization標頭值。 authorization標頭值不包含必要的Bearer權杖。- 提供的授權權杖格式無效。
- 資料流需要驗證，但請求缺少必要的標頭。
EXEG-0501-401無效的使用者授權權杖
此錯誤訊息會在下列任一情況下顯示：
- API呼叫缺少必要的
x-user-token標頭。 - 提供的使用者權杖格式無效。
EXEG-0504-401缺少必要產品內容。
此錯誤訊息會在下列任一情況下顯示：
- 開發人員帳戶無法存取Adobe Experience Platform產品內容。
- 公司帳戶尚無權使用AdobeExperience Platform。
EXEG-0505-401缺少所需的授權權杖範圍
此錯誤僅適用於服務帳戶驗證。 當呼叫中包含的服務授權權杖屬於沒有
acp.foundation IMS範圍存取權的服務帳戶時，便會顯示錯誤訊息。EXEG-0506-401沙箱無法供寫入
當開發人員帳戶對定義資料流的Experience Platform沙箱沒有
WRITE存取權時，便會顯示此錯誤訊息。recommendation-more-help
f36c2cef-1417-40aa-a11d-5d0abaee121b