> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Postman コレクション

> ABBYY Vantage Postman コレクションを使用して Vantage API をテストおよび確認します。ダウンロードし、変数を設定し、認証して、処理エンドポイントを呼び出します。

ABBYY Vantage API Postman Collection は、Vantage API の機能を簡単にテストおよび確認できる Postman コレクションです。

<div id="download">
  ## ダウンロード
</div>

<CardGroup cols={1}>
  <Card title="Postman コレクション" icon="rocket" href="https://www.abbyy.com/marketplace/assets/host/abbyy/connector/postman---abbyy-vantage-api-collection/">
    ABBYY Marketplace から入手できます。
  </Card>
</CardGroup>

<div id="usage">
  ## 使用方法
</div>

まず、コレクション ("ABBYY Vantage API") を開き、Variables タブに移動します。お使いの Vantage テナントで確認できる値を入力します。

* baseUrl: 既定では米国リージョンが設定されています。欧州の場合は "[https://vantage-eu.abbyy.com\&quot;、APAC](https://vantage-eu.abbyy.com\&quot;、APAC) の場合は "[https://vantage-au.abbyy.com](https://vantage-au.abbyy.com)" に変更します。
* clientId と clientSecret: Vantage サイトの Configuration → 公開 API クライアント から取得します。
* scope: 事前に設定されていますが、必要に応じて調整できます。

次に、アクセストークンを取得します。

オプション 1: コレクションの OAuth 2.0 ヘルパーを使用

* コレクションを開き、Authorization に進みます。
* Get New Access Token をクリックします。
* OAuth フローを完了し、その後 Use Token を選択します。
* これにより "vantageAccessToken" が更新され、すべての呼び出しがこの値を継承します。

オプション 2: 明示的な “Get Access Token” リクエストを使用

* Get Access Token (Client Credentials) (または別のトークンリクエスト) を開きます。
* Send をクリックすると、ポストレスポンススクリプトがトークンを "vantageAccessToken" に保存します。
* その後、他のすべてのリクエスト (例: Skill に関する詳細情報を取得するリクエスト) は、継承された認証情報を使用して実行されます。

<div id="environments">
  ### 環境
</div>

複数の Vantage テナントや環境にアクセスできる場合は、このコレクションで共有されている「dev」および「prod」環境をインポートしておくことで、テナント間を簡単に切り替えられるようにすることを検討してください。

<div id="vantage-30">
  ### Vantage 3.0
</div>

v2 フォルダー内にあるエンドポイントは、Vantage 3.0 以降でのみ使用できます。

<div id="changelog">
  ## 変更履歴
</div>

<Update label="2026年2月" description="Vantage 3.0 サポート">
  Postman コレクションを刷新し、デザインを整理して Vantage 3.0 のリリース向けに更新しました。

  * Vantage 3.0 以降で利用可能な reporting/v2 API を追加しました。
  * テナント間の切り替えを容易にするため、開発環境および本番環境を追加しました。
  * このリリースは Vantage v2.x および 3.0 以降の両方をサポートします。
</Update>

<Update label="2024年10月" description="">
  Code Flow 認証と ROPC 認証用にエンドポイントを分離しました。
</Update>