設定知識庫 API 存取權

上次更新時間 2026年10月12日

設定測試 Knowledge Base API 或將應用程式連接至該 API 所需的驗證。

Knowledge Base API 要求使用持有人權杖驗證。使用已驗證的使用者權杖進行短期測試,或為應用程式或整合設定技術帳戶。

開始之前

請確保:

  • 您的組織有權存取 Knowledge Base。
  • 您有權存取工作流程所需的 API 資源。
  • 如果要設定應用程式整合,您可以存取 Adobe Developer Console。

API 存取權不會覆寫 Knowledge Base 權限。已驗證的身分必須有權存取應用程式請求的集合、文件和操作。

選擇驗證方法

使用與您開發階段相符的驗證方法。

使用案例 驗證
測試請求或探索 API 已驗證的使用者持有人權杖
建置應用程式或整合 技術帳戶

使用者持有人權杖

已驗證的使用者持有人權杖適用於測試 API 請求,包括透過 API 參考文件提出的請求。

權杖代表已登入的使用者,有效期限為 24 小時。使用權杖提出的請求,與該使用者可用的 Knowledge Base 存取權相同。

取得使用者 Bearer 權杖後,請在每個請求中包含此權杖:

授權方式:持有人 <access-token>

您也可以將權杖與互動式 Knowledge Base API 參考文件搭配使用,以測試可用的端點。

首先進行擷取您已有存取權之資源的操作。成功的回應可確認權杖已被接受,且已驗證的身分可以存取該資源。

開啟 Knowledge Base API 參考資料

注意

建置持續性應用程式整合時,請勿依賴使用者持有人權杖。

技術帳戶

針對需要在沒有互動式使用者工作階段的情況下進行驗證的應用程式和整合,請使用技術帳戶。

技術帳戶是透過 Adobe Developer Console 進行設定。依循技術帳戶設定程序,建立您的應用程式所需的認證。

建立技術帳戶

建立技術帳戶後,請返回此頁面驗證您對 Knowledge Base API 的存取權。

瞭解 API 權限

驗證會確立發出 API 要求的身分。授權會判斷該身分可以執行什麼動作。

例如,通過驗證的身分能夠擷取一個集合,但不能擷取另一個集合,或可能無法存取管理員層級的資源。

如果驗證成功但操作被拒絕,請先確認已驗證的身分具有存取所要求資源的權限,再將回應視為驗證失敗。

驗證您的 API 存取權

設定驗證後:

  1. 取得存取權杖。
  2. 向已驗證身分可以存取的資源提交要求。
  3. 確認 API 傳回預期的回應。
  4. 繼續進行 API 入門工作流程。

開始使用 Knowledge Base API