Tratta il risultato di conversione come un lavoro con stato, non come un download sincrono di file. In questo modo il prodotto rimane affidabile quando i file sorgente sono grandi, non disponibili o non validi.
Ripeti in sicurezza
Ripeti solo le richieste che possono essere eseguite nuovamente senza rischi. Una richiesta di risultato può essere ritentata con backoff esponenziale. Per le richieste di invio, conserva l'ID attività restituito da una risposta riuscita prima di tentare un nuovo invio.
Gestisci gli errori finali
Quando un'attività è failed, registra il suo ID e il motivo restituito insieme al tuo ID interno del lavoro. Mostra agli utenti un passaggio successivo concreto, come controllare l'URL sorgente o caricare un PDF leggibile, invece di esporre un errore API non formattato.
Imposta limiti di tempo pratici
Usa una scadenza di interrogazione coerente con l'esperienza del prodotto. Interrompi l'interrogazione alla scadenza, conserva l'ID attività e lascia che un processo in background o un aggiornamento avviato dall'utente controlli lo stato finale in seguito.
Consulta il Riferimento API per campi di risposta ed esempi di errore precisi.