資料擷取API快速入門

您可以使用資料擷取API端點來執行基本CRUD操作,以在Adobe Experience Platform中內嵌資料。

若要使用API指南,您必須妥善了解使用資料時涉及的多項Adobe Experience Platform服務。 使用資料擷取API之前,請先檢閱下列服務的檔案:

  • 批次內嵌:可讓您將資料以批次檔案的形式內嵌至Adobe Experience Platform。
  • Real-time Customer Profile:根據來自多個來源的匯總資料,即時提供統一的客戶設定檔。
  • Experience Data Model (XDM):Platform用來組織客戶體驗資料的標準化架構。
  • Sandboxes: Experience Platform 提供可將單一執行個體分割成個 Platform 別虛擬環境的虛擬沙箱,以協助開發及改進數位體驗應用程式。

以下小節提供您需要了解的其他資訊,以便成功呼叫Profile API端點。

讀取範例API呼叫

資料擷取API檔案提供範例API呼叫,以示範如何正確格式化請求。 這些功能包括路徑、必要標題和格式正確的請求裝載。 也提供API回應中傳回的範例JSON。 如需範例API呼叫檔案中所使用慣例的資訊,請參閱Experience Platform疑難排解指南中如何讀取範例API呼叫一節。

必要標題

API檔案也要求您完成authentication tutorial,才能成功呼叫Platform端點。 完成驗證教學課程會提供Experience Platform API呼叫中每個必要標題的值,如下所示:

  • Authorization: Bearer {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {IMS_ORG}

請求內文中具有裝載的所有請求(例如POST、PUT和PATCH呼叫)都必須包含Content-Type標題。 呼叫參數中會提供每個呼叫專屬的接受值。

Experience Platform中的所有資源都與特定虛擬沙箱隔離。 對Platform API的請求需要標題,以指定要在中執行操作的沙箱名稱:

  • x-sandbox-name: {SANDBOX_NAME}

如需Platform中沙箱的詳細資訊,請參閱沙箱概觀檔案

本頁內容