Traitez le résultat d'une conversion comme une tâche avec état, et non comme un téléchargement de fichier synchrone. Votre produit restera ainsi fiable lorsque les fichiers source sont volumineux, indisponibles ou mal formés.
Réessayer en toute sécurité
Ne répétez que les requêtes qui peuvent l'être sans risque. Une requête de résultat peut être répétée avec un délai exponentiel. Pour les requêtes d'envoi, conservez l'identifiant de tâche retourné par une réponse réussie avant de soumettre à nouveau.
Gérer les échecs finaux
Lorsqu'une tâche est failed, journalisez son identifiant et le motif retourné avec votre identifiant interne de travail. Proposez à l'utilisateur une étape concrète, par exemple vérifier l'URL source ou envoyer un PDF lisible, plutôt que d'exposer une erreur API brute.
Définir des limites de temps réalistes
Utilisez une échéance d'interrogation adaptée à l'expérience de votre produit. Arrêtez l'interrogation à cette échéance, conservez l'identifiant de tâche et laissez un processus en arrière-plan ou une actualisation de l'utilisateur vérifier le statut final plus tard.
Consultez la Référence API pour les champs de réponse exacts et les exemples d'échec.