Créer une TSR avec les API Premium

Les API Premium simplifient la création de requêtes et l’exploitation des preuves. Elles utilisent les mêmes accès Basic que l’API TSA, avec les droits Premium activés. Leur résultat d’émission reste une TSR binaire.

Depuis un SHA-256 local

POST /api/timestamp/premium/tsr-from-hash attend le champ hash, sous la forme d’un SHA-256 hexadécimal de 64 caractères, sans préfixe 0x.

curl --fail-with-body --silent --show-error \
  --user 'UTILISATEUR_API' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/timestamp-reply' \
  --data @demande-hash.json \
  --output reponse.tsr \
  'https://my.datasure.net/api/timestamp/premium/tsr-from-hash'

Contenu de demande-hash.json à construire avec votre empreinte réelle :

{"hash":"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"}

Cette empreinte d’exemple est celle d’un contenu vide. Ne l’utilisez pas pour votre document. Vérifiez le résultat avec les données qui ont réellement servi au calcul.

Depuis un fichier transmis

POST /api/timestamp/premium/tsr-from-file attend un fichier dans le champ multipart file. Le service en calcule le SHA-256.

curl --fail-with-body --silent --show-error \
  --user 'UTILISATEUR_API' \
  --header 'Accept: application/timestamp-reply' \
  --form '[email protected]' \
  --output reponse.tsr \
  'https://my.datasure.net/api/timestamp/premium/tsr-from-file'

Un seul fichier est traité par requête. Le contrôleur fixe une limite à 100 × 1024 × 1024 octets. Une limite de téléversement plus basse peut s’appliquer dans votre environnement. Laissez cURL construire l’en-tête multipart et sa boundary.

Lire les propriétés d’une TSR

POST /api/timestamp/premium/process-tsr reçoit la TSR binaire brute et renvoie un JSON décrivant generation_time, unix_time, message_imprint, hash_algorithm, serial_number, nonce et signature_algorithm_oid.

curl --fail-with-body --silent --show-error \
  --user 'UTILISATEUR_API' \
  --header 'Content-Type: application/timestamp-reply' \
  --header 'Accept: application/json' \
  --data-binary @reponse.tsr \
  'https://my.datasure.net/api/timestamp/premium/process-tsr'

Cette opération décode la TSR et vérifie certains éléments de structure et de statut. Elle ne remplace pas la validation complète de la signature, de la chaîne de confiance et du lien au document. Un algorithme ancien reconnu par le décodeur n’est pas pour autant autorisé pour de nouvelles émissions.

Références : Depuis un hash, depuis un fichier, vérification.