Acrobat の Analyzer で API リクエストを作成する

Last updated on 2026年10月28日

組織の地域 API エンドポイントを決定し、リクエストを認証して、Acrobat API で Analyzer を使用します。

Analyzer API を呼び出す前に、組織の API アクセスポイントを特定します。Analyzer は現在 NA1 および EU1 地域をサポートしています。

はじめる前に

Acrobat の Analyzer の API アクセスを設定を完了し、有効な OAuth サーバー間アクセストークンを取得します。

地域別 API エンドポイントの決定

Analyzer は baseUris エンドポイントを使用して、組織の地域別 API アクセスポイントを識別します。

baseUris エンドポイントは NA1 経由でのみ利用できます。組織が EU1 でホストされている場合でも、NA1 エンドポイントを呼び出します。

Analyzer baseUris エンドポイントに認証済み GET リクエストを送信します:

応答から apiAccessPoint 値を読み取ります。

この応答は、組織に割り当てられた地域 API エンドポイントを識別します。

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

返された apiAccessPoint を、後続の Analyzer 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 の代理アクセスの設定を参照してください。