Télécharger les documents et la preuve en une archive
Récupérer en une seule archive ZIP les documents d'un parcours terminé et son fichier de preuve.
GET https://staging-api.docage.com/Transactions/DownloadDocumentsAndProofFile/cccccccc-0000-4000-8000-000000000003
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9…curl "https://staging-api.docage.com/Transactions/DownloadDocumentsAndProofFile/cccccccc-0000-4000-8000-000000000003" \
-H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9…"using HttpClient client = new();
using HttpRequestMessage request = new(HttpMethod.Get, "https://staging-api.docage.com/Transactions/DownloadDocumentsAndProofFile/cccccccc-0000-4000-8000-000000000003");
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/DownloadDocumentsAndProofFile/cccccccc-0000-4000-8000-000000000003", {
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 une archive ZIP (application/zip), nommée d'après le parcours. Elle contient les documents, comme
Télécharger tous les documents d'un parcours, et, pour un parcours terminé (GlobalStatus à 3), son fichier
de preuve : « Contrat de prestation (fichier de preuve).pdf ».
Les refus
401: jeton absent ou expiré.404: le parcours est introuvable, ou vous ne le voyez pas — cette route ne distingue pas les deux cas.400: l'archive n'a pas pu être composée ; le message dit pourquoi.
Les pièges
- La preuve peut manquer sans erreur. Tant qu'elle n'est pas prête — dans les instants qui suivent la fin du parcours —, ou pour un
parcours qui n'est pas terminé ou qui n'a pas de signature, l'archive ne contient que les documents, et la réponse reste
200. Quand la preuve compte, vérifiez qu'elle est dans l'archive, ou préférez les deux routes séparées : la preuve seule répond400tant qu'elle n'est pas prête. - La version précédente de l'API rendait l'archive encodée en base64 dans un JSON : elle arrive désormais telle quelle.