Vai al contenuto principale
La piattaforma ABBYY Vantage fornisce due API REST per integrare l’elaborazione intelligente dei documenti nelle tue applicazioni:

Processing API

Invia documenti, gestisci le transazioni e recupera i dati estratti

Reporting API

Accedi ai dati analitici e di reportistica aziendale

​
URL di base

Tutte le richieste API vengono effettuate al server di produzione di Vantage: 
https://vantage-us.abbyy.com

​
Autenticazione

La Vantage API utilizza OAuth 2.0 per l’autenticazione. Ogni richiesta deve includere un token di accesso nell’intestazione Authorization: 
Authorization: Bearer {your_access_token}
Vantage supporta tre flussi di autenticazione:
FlussoIdeale per
Resource Owner Password CredentialsIntegrazioni server-to-server
Authorization Code FlowApplicazioni con interfaccia utente
Client CredentialsComunicazione macchina-a-macchina
Contatta ABBYY per richiedere un tenant in ABBYY Vantage. Una volta che hai un account tenant, puoi creare account utente e client API per l’autenticazione.

​
API di elaborazione

La Processing API (/api/publicapi/v1/) consente di:
  • Creare transaction — Inviare documenti all’elaborazione con uno specifico skill
  • Gestire file — Caricare, modificare e organizzare le immagini dei documenti
  • Monitorare lo stato — Verificare l’avanzamento delle transaction e gestire gli errori
  • Recuperare i risultati — Scaricare i dati estratti in formato JSON o XML
  • Gestire i cataloghi — Lavorare con cataloghi di dati e tabelle di ricerca

​
Flussi di lavoro comuni

Elabora i documenti con una singola richiesta che gestisce automaticamente caricamento, elaborazione e recupero dei risultati.Scopri di più →
Utilizza chiamate API separate per avere un controllo più dettagliato sul caricamento dei documenti, sull’elaborazione e sul recupero dei risultati.Scopri di più →
Integra la revisione manuale nel tuo flusso di lavoro per i documenti che richiedono una verifica umana.Scopri di più →

​
Reporting API

La Reporting API (/api/reporting/v2/) fornisce accesso a:
  • Metriche aziendali — volumi delle Transaction, tempi di elaborazione e throughput
  • Analytics di qualità — accuratezza dell’estrazione e punteggi di confidenza
  • Dati a livello di Field — risultati di estrazione dettagliati per l’analisi
Ulteriori informazioni su Reporting →

​
Formati di output

Vantage restituisce i dati estratti in formati strutturati:

Output JSON

Dati gerarchici con tutti i dettagli di estrazione e punteggi di attendibilità

Output XML

Markup strutturato per sistemi che richiedono l’integrazione tramite XML

​
Risorse per sviluppatori

Guida per sviluppatori

Guida completa all’integrazione con Vantage API

Raccolta Postman

Raccolta API pronta all’uso per test ed esplorazioni

​
Limiti di utilizzo e buone pratiche

  • Operazioni batch — Usa gli endpoint batch quando elabori più record (fino a 5.000 record di catalogo per richiesta)
  • Polling — Quando controlli lo stato della transaction, usa intervalli ragionevoli (5-10 secondi)
  • Gestione degli errori — Implementa un meccanismo di ritentativo con backoff esponenziale per gli errori temporanei

​
Prossimi passaggi

1

Configura l'autenticazione

Configura OAuth 2.0 per la tua applicazione
2

Elabora il tuo primo documento

Segui la guida all’elaborazione per inviare un documento
3

Esplora l'API

Esplora la documentazione di riferimento completa di Processing API e Reporting API