Rechercher et récupérer les preuves TSA

TSA Premium permet d’exploiter les opérations déjà enregistrées. Conservez dès la création le numéro de série exact renvoyé ou lu dans le jeton, généralement présenté avec le préfixe 0x. Évitez de le convertir en nombre dans votre langage : il peut dépasser la précision d’un entier ou d’un nombre JavaScript.

Parcours recommandé

flowchart TD
  A{"Référence disponible"} -->|Numéro de série| C["Lire les détails"]
  A -->|Empreinte| B["Rechercher les numéros de série"]
  B --> C
  C --> D{"Résultat nécessaire"}
  D -->|Preuve technique| E["Télécharger la TSR"]
  D -->|Document lisible| F["Générer le certificat PDF"]
  E --> G["Vérifier et conserver"]
  F --> G
  classDef default fill:#EDF4FF,stroke:#2B61B5,color:#172F55

Endpoints

Méthode et chemin	Résultat
`GET /api/timestamp/premium/find-timestamps/{fingerprint}`	Tableau JSON de numéros de série associés à l’empreinte
`GET /api/timestamp/premium/get-details/{serialNumber}`	Métadonnées JSON et champ `token`
`GET /api/timestamp/premium/get-tsr/{serialNumber}`	TSR binaire à télécharger
`GET /api/timestamp/premium/get-certificate/{serial_number}`	Certificat d’opération PDF généré et signé par Datasure

Le paramètre fingerprint est l’empreinte du document, pas celle du fichier TSR. Pour un même contenu horodaté plusieurs fois, la recherche peut renvoyer plusieurs séries. Sélectionnez l’opération correspondant à votre contexte métier ; ne prenez pas systématiquement le premier résultat.

Détails et formats

La réponse de détails expose serial_number, fingerprint, hash_algorithm, nonce, oid, timestamp, unix_time, version et token. Le champ token contient la TSR encodée en Base64 dans ce contrat de réponse ; son nom ne signifie pas qu’il s’agit du seul TimeStampToken extrait.

Préférez unix_time pour vos conversions temporelles et vérifiez le fuseau des chaînes de date. Le numéro de série et les métadonnées facilitent l’identification ; la preuve cryptographique reste la TSR.

Certificat d’opération

Le certificat PDF décrit une opération existante et fournit un support lisible. Sa génération est annoncée à un jeton supplémentaire par certificat généré. Même si l’endpoint utilise GET, il ne doit pas être traité comme un téléchargement gratuit à rafraîchir continuellement. Conservez le PDF obtenu et maîtrisez les nouvelles générations.

L’ancien POST /api/timestamp-certificate reçoit serial_number dans le corps et fournit le même type de document. Utilisez de préférence le chemin Premium explicite.

Indexation différée

L’enregistrement et le décompte de la TSR sont traités de manière asynchrone. Juste après une émission, un 404 dans les fonctions de consultation peut traduire un délai d’indexation. Réessayez la lecture avec un délai borné. Ne créez pas un nouveau jeton pour rendre l’ancien visible.

La route d’export en masse /api/generate-bulk-pdf relève d’un traitement accompagné ; ce n’est pas un contrat de téléchargement ZIP immédiat. Faites préciser les accès, la volumétrie et la restitution avant de l’intégrer.