Incorporer un horodatage dans un PDF

L’API PDF ajoute un horodatage documentaire au PDF transmis. Vous recevez un nouveau PDF contenant la preuve. Cette opération n’utilise pas un certificat de cachet au nom de votre organisation et ne remplace pas un cachet Click&Cert.

Requête

Élément	Valeur
Endpoint principal	`POST /api/timestamp/premium/pdf`
Alias	`POST /api/timestamp/pdf`
Corps	Multipart avec le champ `pdf`
Prérequis	TSA Premium, droits d’émission et solde utilisable le cas échéant
Sortie	Fichier PDF contenant l’horodatage

Les deux chemins appellent le même traitement et imposent les mêmes droits Premium. L’absence du mot premium dans l’alias n’en fait pas un accès standard.

curl --fail-with-body --silent --show-error \
  --user 'UTILISATEUR_API' \
  --header 'Accept: application/pdf' \
  --form '[email protected]' \
  --output document-horodate.pdf \
  'https://my.datasure.net/api/timestamp/premium/pdf'

Utiliser le résultat

Conservez le PDF retourné sans le réécrire. Une conversion bureautique, une optimisation ou une modification des octets après traitement peut invalider la preuve ou modifier l’état de validation présenté par le lecteur.

Dans un lecteur PDF disposant de fonctions de validation, ouvrez le panneau des signatures et examinez l’horodatage, son certificat et sa chaîne de confiance. L’aspect visuel d’une page ne permet pas de conclure à la validité cryptographique du résultat.

PDF déjà signé ou protégé

Testez vos modèles réels avant la production : certificats de document, restrictions DocMDP, formulaires, signatures existantes et protection par mot de passe peuvent limiter les modifications acceptées. Un horodatage supplémentaire doit respecter les contraintes déjà présentes dans le PDF.

Le contrôleur ne publie pas ici de plafond métier universel de taille pour les PDF. Les limites serveur et celles de l’environnement s’appliquent ; la limite de l’endpoint tsr-from-file ne doit pas être transposée automatiquement à cette route.

Erreurs utiles

Un fichier absent ou un format non PDF peut entraîner un 400. Des droits ou un solde insuffisants entraînent un refus d’accès. Un échec du moteur PDF peut produire un 422, et une défaillance interne un 500. Contrôlez le statut et le type de contenu avant d’archiver la sortie comme PDF.

Référence de l’API PDF · Choisir entre PDF horodaté et cachet.