Errori API e tentativi
Risposte di errore strutturate, idempotenza e recupero dell'elaborazione asincrona.
Errori HTTP prevedibili#
401/403 indica un errore di autenticazione o autorizzazione. 404 nasconde gli oggetti inaccessibili. 409 segnala impostazioni immutabili, caricamenti già utilizzati o stato attività non valido. 413 applica limiti di dimensione, 422 convalida le impostazioni e 429 sta limitando la velocità/concorrenza.
I guasti transitori del servizio commerciale o della coda restituiscono 503. Riprova l'elaborazione con lo stesso ID attività e opzioni identiche, utilizzando backoff esponenziale e un budget di tentativi limitato.
Esempio di recupero#
# Safe repeated processing attempt for the SAME task and options
curl -X POST https://api.pdfhq.io/v1/tasks/TASK_ID/process \
-H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"options":{"compression_level":"recommended"}}'Un'attività di elaborazione non riuscita non può essere annullata semplicemente eliminando l'attività. Consulta l'utilizzo dell'account e il supporto quando indaghi le discrepanze di liquidazione.
