Télécharger le fichier de preuve

Récupérer le fichier de preuve d'un parcours signé — le PDF scellé et horodaté à produire en cas de litige.

2 min de lecture Mise à jour le 10 novembre 2026

Le fichier de preuve dit tout ce qui s'est passé dans le parcours : son résumé, l'empreinte de chaque document signé, les signataires et la façon dont chacun a été identifié, la chronologie de chaque geste. C'est un PDF scellé et horodaté, produit à la clôture du parcours.

1Attendre la signature de tous

La preuve n'existe que pour un parcours signé : tous ses signataires ont signé, son SignatureStatus vaut 5. Un parcours sans signature (une simple validation, un formulaire) n'en a pas.

2La télécharger

GET https://staging-api.docage.com/Transactions/DownloadProofFile/cccccccc-0000-4000-8000-000000000003/PDF
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9…

curl "https://staging-api.docage.com/Transactions/DownloadProofFile/cccccccc-0000-4000-8000-000000000003/PDF" \
  -H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9…"

using HttpClient client = new();
using HttpRequestMessage request = new(HttpMethod.Get, "https://staging-api.docage.com/Transactions/DownloadProofFile/cccccccc-0000-4000-8000-000000000003/PDF");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", token);
using HttpResponseMessage response = await client.SendAsync(request);
string result = await response.Content.ReadAsStringAsync();
if (!response.IsSuccessStatusCode)
    throw new HttpRequestException(result);

const response = await fetch("https://staging-api.docage.com/Transactions/DownloadProofFile/cccccccc-0000-4000-8000-000000000003/PDF", {
  headers: {
    Authorization: `Bearer ${token}`
  }
});
const text = await response.text();
if (!response.ok) throw new Error(text);
const result = text ? JSON.parse(text) : null;

La réponse est le PDF lui-même (application/pdf), nommé d'après le parcours : « Contrat de prestation (Fichier de preuve).pdf ».

Les refus

Code	Ce qu'il dit
`400` « Le parcours doit être signé »	Tous n'ont pas signé, le parcours a été refusé, ou il n'a pas de signature.
`400` « Le fichier de preuve n'est pas encore prêt, veuillez réessayer plus tard. »	Le parcours est signé, sa preuve se compose : réessayez.
`404`	Le parcours est introuvable, ou vous ne le voyez pas : la réponse ne distingue pas les deux cas.

La preuve se compose à la clôture, dans les secondes qui suivent la dernière signature : le cachet de chaque document, puis la preuve, scellée et horodatée. Si l'un de ces services ne répond pas à cet instant, la clôture est rejouée automatiquement, au plus tard dans l'heure : réessayez à intervalles, sans renvoyer le parcours.

Les pièges

Demandez toujours le format PDF : c'est la seule forme de la preuve d'un parcours signé dans Docage. Un autre format rend le même PDF, mal étiqueté (application/zip pour ZIP).
La version précédente de l'API rendait la preuve encodée en base64 dans un JSON : elle arrive désormais telle quelle.
Un parcours d'essai (IsTest) a une preuve filigranée « essai » : elle n'a pas de valeur probante.
La preuve est aussi un document du parcours (TransactionFiles[], Type 2) : GET https://staging-api.docage.com/TransactionFiles/Download/{id} la télécharge de même.

Pour aller plus loin

GET https://staging-api.docage.com/Transactions/SignatureAuditJournal/{id} rend le journal de preuve du parcours en JSON — chaque événement, dans l'ordre —, pour une vérification par un outil d'audit externe. Un parcours introuvable, ou que l'utilisateur ne voit pas, répond 404, avec le même message : la réponse ne dit pas si un parcours existe.