Logo PDFHQ

Documenti

DocumentazioneGuida introduttiva

Errori API e tentativi

Risposte di errore strutturate, idempotenza e recupero dell'elaborazione asincrona.

Chiavi API lato server Caricamenti di archiviazione firmati

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#

cURL
# 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.

Logo PDFHQ

Strumenti PDF e intelligenza documentale. Prepara, comprendi e lavora con i tuoi documenti.

© 2026 PDFHQ. Tutti i diritti riservati.