Sviluppatori
Invia un job API cliente
Chiavi, idempotenza, limiti e paginazione dei risultati.
Usa una chiave con ambiti limitati
Usa una chiave Live con ambito submit per la verifica in produzione. Conservala sul tuo server e assegna solo gli ambiti submit, read o balance di cui hai bisogno. Le chiavi Test simulano indirizzi di esempio riservati senza chiamate al provider né utilizzo di crediti.
Il limite della chiave live conteggia i crediti scalati più le riserve accettate. Se il limite viene raggiunto, un nuovo job viene rifiutato senza creare alcuna riserva. I crediti del workspace vengono riservati man mano che le verifiche vengono ammesse all'elaborazione, con le stesse regole di consumo e restituzione della dashboard.
Nuovi tentativi sicuri
Invia un Idempotency-Key stabile insieme a un job. Un nuovo tentativo corrispondente restituisce lo stesso job. Usa l’ID del job restituito per leggerne lo stato e i risultati paginati. Una chiave ripetuta con un payload diverso viene rifiutata.
Una pausa operativa può rifiutare temporaneamente nuovi job live con HTTP 503 live_verification_unavailable e senza alcuna riserva di crediti. Riprova più tardi con la stessa chiave di idempotenza. Questo è distinto dalle autorizzazioni delle chiavi API, dai limiti delle chiavi e dai limiti di frequenza.