Erreurs, délais et nouvelles tentatives : évitez les doublons
Sachez quand réessayer, quand corriger la requête et comment éviter de recréer une tâche asynchrone.

Comprenez l'erreur avant de répéter
Une requête mal formée, une clé invalide ou un paramètre non pris en charge demandent généralement une correction. Une limitation de débit ou une erreur temporaire peut justifier une nouvelle tentative selon la documentation. Conservez le statut et l'identifiant de requête sans écrire les secrets ou prompts sensibles dans les journaux.
Une erreur d’authentification ou de droits demande de vérifier clé et accès. Un format, modèle ou paramètre incorrect demande de modifier la requête. Une limitation de débit ou une panne temporaire peut être réessayée selon la documentation. Tout appeler « erreur réseau » masque des indices et peut provoquer des répétitions inutiles.
Laissez le temps au service de récupérer
Pour les erreurs qui le permettent, limitez le nombre de tentatives avec un délai croissant et une variation aléatoire. Respectez le délai fourni par le serveur quand il existe. Fixez une échéance globale et évitez que tous les clients ne réessaient simultanément.
Pour les erreurs dont la documentation autorise la reprise, limitez le nombre d’essais et le temps total, augmentez le délai et ajoutez une variation aléatoire. Respectez un délai explicite fourni par le serveur. L’utilisateur doit pouvoir annuler ; une fois la limite atteinte, arrêtez au lieu de consommer indéfiniment des ressources.
Après une panne temporaire, une nouvelle tentative suit une stratégie contrôlée.Attention aux effets de bord
Un délai dépassé peut survenir après l'acceptation de la demande. Une deuxième tâche d'image ou de vidéo peut répéter le travail et les frais. Conservez l'identifiant renvoyé et vérifiez l'état avant de soumettre à nouveau ; utilisez l'idempotence seulement si l'interface la documente.
Un délai dépassé après l’envoi peut signifier que la réponse a été perdue alors que la tâche existe. Conservez et consultez son identifiant s’il a été reçu ; sinon, ne supposez pas qu’elle est absente. Vérifiez si l’interface documente recherche, callback ou idempotence et suivez sa procédure de reprise. Expliquez les frais possibles avant une nouvelle création.
Aidez la personne qui attend
Indiquez s'il faut réessayer, modifier l'entrée ou revenir plus tard. Conservez si nécessaire le texte partiel d'un flux et précisez qu'il est incomplet. Testez séparément une requête invalide, une limitation, une coupure réseau et une tâche lente : ces situations méritent des messages différents.
Heure, identifiant, interface, statut, durée et catégorie d’erreur suffisent souvent à commencer l’enquête. Ne consignez pas clés complètes, en-têtes d’autorisation ou prompts inutiles ; vérifiez les données personnelles avant partage. L’utilisateur a besoin d’une suite claire, le mainteneur d’un contexte traçable mais limité.
Simulez séparément paramètre invalide, erreur d’authentification, limitation, coupure et tâche lente. Vérifiez que seules les erreurs adaptées sont réessayées, que les délais sont bornés et que les résultats partiels sont conservés si nécessaire. Testez plusieurs clics sur réessayer pour détecter les doublons. L’exercice ne doit pas utiliser de données clients réelles ni créer de tâches payantes en production.
Identifier le type d’échec
Conservez le code, l’identifiant, l’heure et une erreur expurgée. Une erreur d’authentification exige de vérifier la clé ou les droits ; des paramètres invalides doivent être corrigés. Une limite de débit ou une panne temporaire peut, selon la documentation, permettre une nouvelle tentative.
Un délai dépassé après l’envoi ne prouve pas que le service distant n’a rien fait. L’opération peut encore être en cours ou terminée. Expliquez à l’utilisateur quoi faire sans exposer de secrets ni de détails internes.
Limiter les nouvelles tentatives
Pour une erreur pouvant être réessayée sans danger, fixez un nombre maximal de tentatives et une durée totale. Un délai croissant avec une part aléatoire évite que de nombreux clients réessaient au même instant. Respectez les indications de l’API.
Évitez que navigateur, serveur et bibliothèque multiplient chacun les tentatives. Pour une création ou une écriture, utilisez un mécanisme d’idempotence réellement pris en charge ou vérifiez la tâche existante. Si le résultat reste incertain, indiquez-le.
Tester la stratégie avec deux exemples
Après une réponse explicite de limitation, conservez la saisie, respectez l’attente et permettez l’annulation ; si les essais échouent, arrêtez le chargement et expliquez la situation.
Si la connexion coupe avant réception de l’identifiant d’une vidéo, vérifiez selon le mécanisme prévu sans créer silencieusement plusieurs tâches. Testez aussi les clés invalides, paramètres incorrects et annulations, et réglez les alertes selon la durée et l’impact.
Deux échecs, deux réponses
Si une requête est limitée et que le service indique un délai, attendez ce délai dans les limites prévues. Si la création d’une vidéo expire après l’envoi, la tâche peut déjà exister : cherchez son identifiant enregistré et consultez son état. Sans identifiant, signalez l’incertitude et suivez la procédure documentée au lieu de supposer qu’un nouvel envoi sera gratuit.
Pour demander de l’aide, fournissez heure, modèle, identifiant de requête et erreur anonymisée. Ne demandez jamais à un utilisateur de publier une clé ou un contenu privé complet. Vérifiez si une tâche existe déjà avant de recommander une reprise ou une nouvelle tentative sûre.