Zum Hauptinhalt springen
Die Postman-Collection für die ABBYY Vantage-API bietet eine einfache Möglichkeit, die Funktionalität der Vantage-API zu testen und zu erkunden.

Download

Verwendung

Öffnen Sie zunächst die Collection („ABBYY Vantage API“) und wechseln Sie dann zur Registerkarte „Variables“. Füllen Sie die Werte aus, die Sie in Ihrem Vantage-Mandanten finden:
  • baseUrl: Standardmäßig auf die Region USA eingestellt. Ändern Sie sie für Europa auf “https://vantage-eu.abbyy.com” oder für APAC auf “https://vantage-au.abbyy.com”.
  • clientId und clientSecret: Werden über die Vantage-Website unter Configuration → Public API Client abgerufen.
  • scope: Vorkonfiguriert, kann aber bei Bedarf angepasst werden.
Als Nächstes rufen Sie ein Access-Token ab. Option 1: Den OAuth-2.0-Helper der Collection verwenden
  • Öffnen Sie die Collection → Authorization.
  • Klicken Sie auf Get New Access Token.
  • Durchlaufen Sie den OAuth-Ablauf und klicken Sie dann auf Use Token.
  • Dadurch wird “vantageAccessToken” aktualisiert und alle Aufrufe erben dieses Token.
Option 2: Die expliziten „Get Access Token“-Requests verwenden
  • Öffnen Sie Get Access Token (Client Credentials) (oder den anderen Token-Request).
  • Klicken Sie auf Send; das Skript nach der Response speichert das Token in “vantageAccessToken”.
  • Alle anderen Requests (z. B. „Gets the detailed information about a Skill“) verwenden dann die geerbte Authentifizierung.

Umgebungen

Wenn Sie Zugriff auf mehrere Vantage-Tenants und/oder Umgebungen haben, sollten Sie in Erwägung ziehen, die mit dieser Sammlung bereitgestellten „dev“- und „prod“-Umgebungen zu importieren, um bequem zwischen Tenants zu wechseln.

Vantage 3.0

Beachten Sie, dass die Endpunkte im Ordner v2 nur in Vantage 3.0 und höher verfügbar sind.