Identity Service API指南
Adobe Experience Platform Identity Service以Adobe Experience Platform內稱為身分圖表的方式，管理跨裝置、跨頻道及幾乎即時的客戶身分識別。
快速入門
本指南需要您深入了解下列 Adobe Experience Platform 元件：
- Identity Service：解決客戶設定檔資料片段化所造成的基本挑戰。 其做法是跨客戶與您品牌互動的裝置和系統橋接身分。
- Real-Time Customer Profile：根據來自多個來源的彙總資料，即時提供統一的消費者設定檔。
- Experience Data Model (XDM)： Experience Platform用來組織客戶體驗資料的標準化架構。
下列章節提供您需知道或有手頭的其他資訊，才能成功呼叫Identity Service API。
讀取範例 API 呼叫
本指南提供範例 API 呼叫，示範如何格式化您的請求。 這些包括路徑、必要的標頭和正確格式化的請求承載。 此外，也提供 API 回應中傳回的範例 JSON。 如需文件中用於範例 API 呼叫的慣例相關資訊，請參閱 Experience Platform 疑難排解指南中的如何讀取範例 API 呼叫一節。
收集所需標頭的值
為了對 Experience Platform API 進行呼叫，您必須先完成驗證教學課程。 完成驗證教學課程會提供所有 Experience Platform API 呼叫中每個必要標頭的值，如下所示：
- 授權：持有人
{ACCESS_TOKEN} - x-api-key：
{API_KEY} - x-gw-ims-org-id：
{ORG_ID}
Experience Platform中的所有資源都與特定的虛擬沙箱隔離。 對Experience Platform API的所有請求都需要標頭，以指定將在其中執行作業的沙箱名稱：
- x-sandbox-name：
{SANDBOX_NAME}
所有包含承載 (POST、PUT、PATCH) 的請求都需有額外的標頭：
- Content-Type： application/json
以區域為基準的製程
Identity Service API採用特定區域的端點，這些端點需要將{REGION}納入請求路徑中。 在貴組織布建期間，區域會進行判定，並儲存在貴組織設定檔中。 對每個端點使用正確的區域，可確保使用Identity Service API提出的所有請求都路由到適當的區域。
Identity Service API目前支援兩個區域： VA7和NLD2。
下表顯示使用區域的範例路徑：
如果您在組織設定檔中找不到地區，請聯絡您的系統管理員以尋求支援。
使用Identity Service API
這些服務中使用的身分引數可以採用以下兩種方式之一來表示：複合或XID。
複合身分是包含ID值和名稱空間的建構。 使用複合身分時，可以透過名稱(namespace.code)或識別碼(namespace.id)提供名稱空間。
當身分持續存在時，Identity Service會產生識別碼並指派給該身分，稱為原生ID或XID。 Cluster和Mapping API的所有變數在其請求和回應中同時支援複合身分和XID。 需要使用其中一個引數 — xid或[ns或nsid]與id的組合，才能使用這些API。
為了限制回應中的裝載，API會調整其回應，以符合所使用的身分建構型別。 也就是說，如果您傳遞XID，您的回應將具有XID；如果您傳遞複合身分，回應將遵循請求中使用的結構。
本檔案中的範例不涵蓋Identity Service API的完整功能。 如需完整的API，請參閱Swagger API參考。
後續步驟
現在您已收集到所需的認證，您可以繼續閱讀開發人員指南的其餘部分。 每個區段都提供有關其端點的重要資訊，並示範用於執行CRUD操作的範例API呼叫。 每個呼叫都包含一般API格式、顯示必要標題和正確格式負載的範例請求，以及成功呼叫的範例回應。