驗證及存取Reactor API
為了使用 Reactor API 若要建立和管理Tags擴充功能,每個要求都必須包含下列驗證標題:
Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {ORG_ID}
本指南說明如何使用Adobe Developer Console收集這些標題的值,以便您開始呼叫Reactor API。
取得開發人員的Adobe Experience Platform存取權 gain-developer-access
您必須先擁有開發人員Experience Platform存取權,才能產生Reactor API的驗證值。 若要取得開發人員存取權,請依照以下說明中的開始步驟操作: Experience Platform驗證教學課程. 當您完成 取得使用者存取權 步驟,返回本教學課程以產生Reactor API的特定認證。
產生存取認證 generate-access-credentials
使用Adobe Developer Console時,您必須產生下列三個存取認證:
{ORG_ID}
{API_KEY}
{ACCESS_TOKEN}
您組織的ID ({ORG_ID}
)和API金鑰({API_KEY}
)可在最初產生後於未來的API呼叫中重複使用。 不過,您的存取權杖({ACCESS_TOKEN}
)是暫時性的,必須每24小時重新產生一次。
以下將詳細介紹產生這些值的步驟。
一次性設定 one-time-setup
前往 Adobe Developer Console 並使用您的Adobe ID登入。 接下來,請依照教學課程中概述的步驟進行 建立空白專案 在開發人員控制檯檔案中。
建立專案後,選取 新增API 於 專案概述 畫面。
此 新增API 畫面隨即顯示。 選取 EXPERIENCE PLATFORM LAUNCH API 從可用API清單中選取 下一個.
接著,選取驗證型別以產生存取權杖並存取Experience PlatformAPI。
選取 「下一步」 以繼續。
下一個畫面會提示您選取一或多個產品設定檔,以與API整合建立關聯。
從清單中選取所需的產品設定檔,然後選取「 」 儲存已設定的API 以完成API註冊。
收集認證 gather-credentials
將API新增至專案後, EXPERIENCE PLATFORM API 專案的頁面會顯示所有Experience PlatformAPI呼叫所需的下列認證:
{API_KEY}
(使用者端ID){ORG_ID}
(組織 ID)
產生存取權杖 generate-access-token
下一步是產生 {ACCESS_TOKEN}
用於平台API呼叫的認證。 不像 {API_KEY}
和 {ORG_ID}
,必須每24小時產生一個新Token才能繼續使用Platform API。
您有兩個選項可依據您的使用案例來產生存取權杖:
手動產生存取權杖 manual
若要手動產生新的 {ACCESS_TOKEN}
,導覽至 認證 > OAuth伺服器對伺服器 並選取 產生存取權杖,如下所示。
會產生新的存取Token,並提供按鈕以將該Token複製到剪貼簿。 此值用於所需的授權標頭,必須以格式提供 Bearer {ACCESS_TOKEN}
.
自動化權杖產生 auto-token
您也可以使用Postman環境和集合來產生存取權杖。 如需詳細資訊,請閱讀以下章節: 使用Postman驗證及測試API呼叫 在Experience Platform API驗證指南中。
測試API認證 test-api-credentials
依照本教學課程中的步驟操作,您應該具備下列專案的有效值: {ORG_ID}
, {API_KEY}
、和 {ACCESS_TOKEN}
. 您現在可以透過在對Reactor API的簡單cURL請求中使用這些值來測試這些值。
首先,嘗試對進行API呼叫 列出所有公司.
在您確認存取認證正常運作後,請繼續探索其他API參考檔案,以瞭解API的眾多功能。
讀取範例 API 呼叫 read-sample-api-calls
每個端點指南都提供API呼叫範例,示範如何格式化您的請求。 這些包括路徑、必要的標頭和正確格式化的請求承載。 此外,也提供 API 回應中傳回的範例 JSON。 如需檔案中用於範例API呼叫的慣例相關資訊,請參閱以下章節: 如何讀取範例API呼叫 (位於平台API快速入門手冊中)。
後續步驟 next-steps
現在您瞭解了要使用哪些標頭,就可以開始呼叫Reactor API了。 選取其中一個端點指南以開始: