驗證及存取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存取權

您必須先擁有開發人員Experience Platform存取權，才能產生Reactor API的驗證值。 若要取得開發人員存取權，請依照以下說明中的開始步驟操作： Experience Platform驗證教學課程. 當您完成 取得使用者存取權 步驟，返回本教學課程以產生Reactor API的特定認證。

產生存取認證

使用Adobe Developer Console時，您必須產生下列三個存取認證：

• {ORG_ID}
• {API_KEY}
• {ACCESS_TOKEN}

您組織的ID ({ORG_ID})和API金鑰({API_KEY})可在最初產生後於未來的API呼叫中重複使用。 不過，您的存取權杖({ACCESS_TOKEN})是暫時性的，必須每24小時重新產生一次。

以下將詳細介紹產生這些值的步驟。

一次性設定

前往 Adobe Developer Console 並使用您的Adobe ID登入。 接下來，請依照教學課程中概述的步驟進行 建立空白專案 在開發人員控制檯檔案中。

建立專案後，選取 新增API 於 專案概述 畫面。

此 新增API 畫面隨即顯示。 選取 EXPERIENCE PLATFORM LAUNCH API 從可用API清單中選取 下一個.

接著，選取驗證型別以產生存取權杖並存取Experience PlatformAPI。

選取​「下一步」​以繼續。

下一個畫面會提示您選取一或多個產品設定檔，以與API整合建立關聯。

從清單中選取所需的產品設定檔，然後選取「 」 儲存已設定的API 以完成API註冊。

收集認證

將API新增至專案後， EXPERIENCE PLATFORM API 專案的頁面會顯示所有Experience PlatformAPI呼叫所需的下列認證：

• {API_KEY} (使用者端ID)
• {ORG_ID} (組織 ID)

產生存取權杖

下一步是產生 {ACCESS_TOKEN} 用於平台API呼叫的認證。 不像 {API_KEY} 和 {ORG_ID}，必須每24小時產生一個新Token才能繼續使用Platform API。

您有兩個選項可依據您的使用案例來產生存取權杖：

• 手動產生代號
• 自動化權杖產生

手動產生存取權杖

若要手動產生新的 {ACCESS_TOKEN}，導覽至 認證 > OAuth伺服器對伺服器 並選取 產生存取權杖，如下所示。

會產生新的存取Token，並提供按鈕以將該Token複製到剪貼簿。 此值用於所需的授權標頭，必須以格式提供 Bearer {ACCESS_TOKEN}.

自動化權杖產生

您也可以使用Postman環境和集合來產生存取權杖。 如需詳細資訊，請閱讀以下章節： 使用Postman驗證及測試API呼叫 在Experience Platform API驗證指南中。

測試API認證

依照本教學課程中的步驟操作，您應該具備下列專案的有效值： {ORG_ID}， {API_KEY}、和 {ACCESS_TOKEN}. 您現在可以透過在對Reactor API的簡單cURL請求中使用這些值來測試這些值。

首先，嘗試對進行API呼叫 列出所有公司.

在您確認存取認證正常運作後，請繼續探索其他API參考檔案，以瞭解API的眾多功能。

讀取範例 API 呼叫

每個端點指南都提供API呼叫範例，示範如何格式化您的請求。 這些包括路徑、必要的標頭和正確格式化的請求承載。 此外，也提供 API 回應中傳回的範例 JSON。 如需檔案中用於範例API呼叫的慣例相關資訊，請參閱以下章節： 如何讀取範例API呼叫 （位於平台API快速入門手冊中）。

後續步驟

現在您瞭解了要使用哪些標頭，就可以開始呼叫Reactor API了。 選取其中一個端點指南以開始：

• Reactor API參考檔案
• Reactor API指南概觀