Identity Service API指南

Adobe Experience PlatformIdentity Service管理跨裝置、跨通道和近乎即時的客戶識別，在Adobe Experience Platform稱為身份圖。

快速入門

本指南需要對Adobe Experience Platform的下列組成部分有切實的瞭解：

• Identity Service:解決客戶個人檔案資料分散所帶來的根本挑戰。它可跨裝置和系統橋接身分，讓客戶與您的品牌互動。
• Real-time Customer Profile:根據來自多個來源的匯整資料，即時提供統一的消費者個人檔案。
• Experience Data Model (XDM):組織客戶體驗資 Platform 料的標準化架構。

以下各節提供您必須知道或掌握的額外資訊，才能成功呼叫Identity Service API。

讀取範例API呼叫

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

收集必要標題的值

若要呼叫Platform API，您必須先完成驗證教學課程。 完成驗證教學課程後，所有Experience Platform API呼叫中每個所需標題的值都會顯示在下面：

• 授權：載體{ACCESS_TOKEN}
• x-api-key:{API_KEY}
• x-gw-ims-org-id:{IMS_ORG}

Experience Platform中的所有資源都隔離到特定的虛擬沙盒。 對Platform API的所有請求都需要一個標題，該標題指定要在中執行操作的沙盒的名稱：

• x-sandbox-name:{SANDBOX_NAME}

所有包含裝載(POST、PUT、PATCH)的請求都需要額外的標題：

• 內容類型：application/json

基於區域的路由

Identity Service API採用區域特定端點，要求在請求路徑中加入{REGION}。 在IMS組織布建期間，會決定地區並儲存在IMS組織描述檔中。 使用每個端點的正確區域可確保使用Identity Service API提出的所有請求都路由到適當的區域。

Identity Service API目前支援兩個地區：VA7和NLD2。

下表顯示了使用區域的示例路徑：

如果您無法在IMS組織設定檔中找到地區，請聯絡您的系統管理員以取得支援。

使用Identity Service API

這些服務中使用的身份參數可以用兩種方式之一表示；複合或XID。

複合身份是包括ID值和命名空間的構造。 使用複合身份時，可以通過名稱(namespace.code)或ID(namespace.id)提供命名空間。

當身分持續存在時，Identity Service會產生ID並指派給該身分，稱為原生ID或XID。 所有群集和映射API的變體在其請求和響應中都支援組合身份和XID。 其中一個參數是必需的- xid或[ns或nsid]和id的組合才能使用這些API。

為了限制回應中的負載，API會根據使用的身分建構類型來調整其回應。 也就是說，如果您傳遞XID，您的回應會有XID，如果您傳遞複合身分，則回應會遵循請求中使用的結構。

本文中的範例不涵蓋Identity Service API的完整功能。 如需完整的API，請參閱Swagger API參考。

後續步驟

現在您已收集到必要的認證，您可以繼續閱讀其餘的開發人員指南。 每個區段都提供其端點的重要資訊，並示範執行CRUD作業的範例API呼叫。 每個呼叫都包含一般API格式、顯示必要標題和正確格式化負載的範例要求，以及成功呼叫的範例回應。