Aller au contenu
Documentation

Télécharger les documents signés et la preuve

Une fois le parcours terminé, récupérer ses documents — un par un ou en archive — et son fichier de preuve.

2 min de lecture Mise à jour le 9 novembre 2026

Un parcours terminé laisse deux choses à garder : ses documents signés, et son fichier de preuve, le PDF scellé à produire en cas de litige. Quatre routes les rendent, chacune décrite dans un guide ci-dessous :

Ce que vous voulez La route
Un document GET https://staging-api.docage.com/TransactionFiles/Download/{id}
Tous les documents, en archive ZIP GET https://staging-api.docage.com/Transactions/DownloadDocuments/{id}
Le fichier de preuve GET https://staging-api.docage.com/Transactions/DownloadProofFile/{id}/PDF
Les documents et la preuve, en archive ZIP GET https://staging-api.docage.com/Transactions/DownloadDocumentsAndProofFile/{id}

Les quatre rendent le fichier lui-même, avec son type (Content-Type) et son nom (Content-Disposition) — pas du JSON. La version précédente de l'API rendait ces fichiers encodés en base64 dans un JSON : lisez désormais le corps de la réponse tel quel.

Quand télécharger

Le parcours est terminé quand son GlobalStatus vaut 3 (« Terminé ») : chaque participant a fait toutes ses actions. Les documents portent alors toutes les signatures, et le cachet final. Le fichier de preuve, lui, n'existe que pour un parcours signé : son SignatureStatus vaut 5.

Plutôt que de relire le parcours, faites-vous prévenir : voir Être prévenu quand un parcours est signé. Le parcours se clôt juste après le changement de statut : son cachet, son horodatage et sa preuve se posent dans les secondes qui suivent. Une preuve demandée trop tôt répond 400 (« pas encore prêt ») : réessayez un peu plus tard.

Les pièges

  • Avant la fin, les documents sont rendus dans leur état du moment : signés en partie. Seul le document final porte toutes les signatures.
  • Un document rédigé dans Docage — un document ou un modèle de document que le parcours remplit — n'est un PDF qu'une fois sa signature préparée, au lancement de l'étape qui signe. Avant, ou dans un parcours sans signature, il se télécharge en document Word (.docx) — en classeur (.xlsx) pour un tableur — sauf si vous demandez format=pdf.
  • Les droits sont ceux du parcours : qui voit le parcours télécharge ses documents et sa preuve.

Dans ce chapitre