Verificare un documento con l'API

L’API REST di VerifyPDF permette ai tuoi sistemi di verificare documenti senza che nessuno apra la dashboard. Questo articolo copre il flusso generale. Per i dettagli completi di richiesta e risposta, usa la documentazione su /agents/.

Prima di iniziare

• L’API REST è disponibile sui piani Professional e Corporate. Non è inclusa in Basic o in un account senza piano. Vedi I piani spiegati.
• Ti serve una chiave API. Vedi Generare e gestire le chiavi API.

Il flusso di base

1. Crea una chiave API nella sezione Developers e copiala una volta.
2. Invia il PDF all’API con la tua chiave nell’header di richiesta API-KEY.
3. Leggi il risultato, che torna con lo stesso trust score e la stessa valutazione del rischio di frode che vedi nella dashboard. Vedi Leggere il risultato della verifica.

Ogni verifica via API consuma un documento dal tuo volume mensile disponibile o dal saldo prepagato, esattamente come un caricamento dalla dashboard. Vedi Come funzionano i pacchetti prepagati.

Aggiungi un tuo id di riferimento

Puoi allegare un custom_id a una verifica, ad esempio il tuo numero di pratica interno o l’id di un ordine. Così puoi ritrovare la verifica più tardi con il tuo riferimento. Ogni custom_id deve essere unico all’interno del tuo account.

Una rapida illustrazione

A grandi linee, una richiesta invia il PDF insieme all’header API-KEY che contiene la tua chiave. L’endpoint esatto, il corpo della richiesta e il formato della risposta si trovano nella documentazione API su /agents/ e dentro la sezione Developers della dashboard. Usa quelle fonti per esempi pronti all’uso invece di tirare a indovinare.

Prima test, poi live

Mentre sviluppi, usa una chiave test. Passa a una chiave live per le verifiche reali. Vedi Chiavi API test e live.

Prossimi passi

• Vuoi che i risultati ti vengano inviati invece di interrogare l’API? Vedi Configurare i webhook.
• Ti serve la documentazione completa? Vai su /agents/.