使用 Acrobat 中的 Analyzer 提出 API 要求

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

確定組織的區域 API 端點、驗證您的要求,以及在 Acrobat API 中使用分析器。

呼叫 Analyzer API 之前,請先為該組織設定 API 存取點。分析器目前支援 NA1 和 EU1 區域。

開始之前

完成為 Acrobat 中的 Analyzer 設定 API 存取權並取得有效的 OAuth 伺服器對伺服器存取權杖。

確定區域 API 端點

分析器使用 baseUris 端點來識別組織的區域 API 存取點。

baseUris 端點僅透過 NA1 提供。 即使組織託管在 EU1,也請呼叫 NA1 端點。

將已驗證的 GET 要求傳送至分析器 baseUris 端點:

從回答中讀取 apiAccessPoint 值。

回答會識別指派給組織的區域 API 端點。

{
"apiAccessPoint": "[regional Analyzer API endpoint]"
}

使用傳回的 apiAccessPoint 作為後續分析器 API 要求的基底 URL。

一律透過 baseUris 來解析組織的 API 存取點,而非將區域性端點硬編碼。

驗證 API 要求

在每個 API 請求的 Authorization 標頭中傳遞 OAuth 伺服器對伺服器存取憑證:

Authorization: Bearer <access_token>

使用 baseUris 傳回的 apiAccessPoint 建構後續的 API 要求。

使用 API 參考

Analyzer 提供區域 Swagger 介面,用於探索端點、參數、要求和回答方案,以及支援的操作。

使用組織區域的 Swagger 介面:

  • NA1:https://analyzer-na1.adobe.io/swagger-ui/index.html
  • EU1:https://analyzer-eu1.adobe.io/swagger-ui/index.html

在測試已驗證的端點之前,請使用有效的 OAuth 伺服器對伺服器存取權杖為 Swagger 作業階段授權。

可用的 API 操作

使用 Analyzer API 來:

  • 上傳文件以進行處理。
  • 搜尋和篩選文件。
  • 擷取文件處理狀態。
  • 擷取可用的屬性。
  • 擷取已抽取的屬性值。

請參閱區域 Swagger 介面,以取得端點路徑、參數、請求綱要、回應綱要和狀態代碼。

下一步

如果您的整合需要存取權個體使用者的 Analyzer 資料,請參閱在 Acrobat 中為 Analyzer 設定代理存取權。