Erreurs, reprises et mise en production TSA

Une intégration doit distinguer les appels qui créent une preuve des appels qui consultent une preuve. Les émissions et les générations de certificats PDF peuvent avoir un coût ; une répétition aveugle peut produire des opérations supplémentaires.

Interpréter les réponses

Statut	Cause possible	Action
`200`	Traitement HTTP réussi	Vérifier le format et, pour une TSR, le statut et la validité RFC 3161
`400`	TSQ invalide, hash incorrect, fichier absent ou TSR inexploitable	Corriger la donnée envoyée
`401`	Identifiants ou droits d’accès manquants selon la route historique	Vérifier compte, en-tête et activation
`403`	Premium, droits TSA ou solde insuffisant	Vérifier l’offre et le compte
`404`	Série ou empreinte absente ; indexation éventuellement en cours	Vérifier la référence ; reprise de lecture bornée si émission récente
`413`	Taille de requête refusée par l’environnement	Réduire la taille ou convenir d’une limite adaptée
`422`	Traitement PDF impossible	Examiner le fichier et ses restrictions
`429`	Limitation du nombre d’appels	Réduire le débit et temporiser
`5xx`	Défaillance technique	Enregistrer le contexte et déterminer si une émission a pu aboutir

Les corps d’erreur historiques peuvent utiliser error ou message, en JSON ou en texte. Ne tentez pas de décoder toutes les réponses comme une TSR.

Débit et files d’attente

Appliquez le plafond souscrit dans votre application avec une file d’attente et une concurrence maîtrisée. Les fonctions de recherche et de preuve partagent également des protections API. Un plafond exprimé par minute côté serveur ne signifie pas qu’une rafale équivalente est autorisée contractuellement.

Utilisez un délai de reprise progressif avec une variation aléatoire. Respectez Retry-After lorsqu’il est fourni ; sinon appliquez un délai borné adapté. Évitez les tests de charge sur la production sans cadrage avec Datasure.

Résultat incertain

flowchart TD
  A["Appel d’émission"] --> B{"Réponse reçue ?"}
  B -->|Oui| C["Contrôler et enregistrer la preuve"]
  B -->|Non| D["Marquer le résultat incertain"]
  D --> E["Rapprocher les traces disponibles"]
  E --> F{"Nouvelle émission nécessaire ?"}
  F -->|Oui| G["Nouvelle opération maîtrisée"]
  F -->|Non| H["Associer la preuve retrouvée"]
  classDef default fill:#EDF4FF,stroke:#2B61B5,color:#172F55

Un timeout ne prouve pas que l’autorité n’a pas émis de jeton. Les API ne documentent pas de mécanisme d’idempotence client. Une recherche par empreinte peut aider au rapprochement avec Premium, mais plusieurs résultats ne permettent pas, seuls, d’identifier votre tentative.

Journalisation et supervision

Enregistrez référence métier, empreinte, algorithme, environnement, instant d’appel, statut, durée et série obtenue. Protégez ces journaux ; excluez mots de passe, en-têtes Authorization et contenu des documents. Conservez les preuves dans un stockage approprié dès réception.

Pour une demande de support, transmettez l’endpoint, l’heure avec fuseau, le statut, la référence et un message d’erreur expurgé. Consultez la page de statut et les engagements de votre offre.