Retirer des documents d'un brouillon
Supprimer un ou plusieurs documents d'un parcours qui n'est pas encore envoyé.
DELETE https://staging-api.docage.com/TransactionFiles/BatchDelete
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9…
Content-Type: application/json
["eeeeeeee-0000-4000-8000-000000000005", "eeeeeeee-0000-4000-8000-000000000015"]curl -X DELETE "https://staging-api.docage.com/TransactionFiles/BatchDelete" \
-H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9…" \
-H "Content-Type: application/json" \
-d '["eeeeeeee-0000-4000-8000-000000000005", "eeeeeeee-0000-4000-8000-000000000015"]'using HttpClient client = new();
using HttpRequestMessage request = new(HttpMethod.Delete, "https://staging-api.docage.com/TransactionFiles/BatchDelete");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", token);
request.Content = new StringContent("""
[
"eeeeeeee-0000-4000-8000-000000000005",
"eeeeeeee-0000-4000-8000-000000000015"
]
""", Encoding.UTF8, "application/json");
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/TransactionFiles/BatchDelete", {
method: "DELETE",
headers: {
Authorization: `Bearer ${token}`,
"Content-Type": "application/json"
},
body: JSON.stringify(["eeeeeeee-0000-4000-8000-000000000005", "eeeeeeee-0000-4000-8000-000000000015"])
});
const text = await response.text();
if (!response.ok) throw new Error(text);
const result = text ? JSON.parse(text) : null;Le corps est la liste des identifiants des documents, d'un ou de plusieurs parcours. Les documents sont supprimés définitivement, avec leurs emplacements de signature, et leur contenu est effacé du stockage.
Les refus
- « Vous ne pouvez pas supprimer les documents d'un parcours en cours ou terminé. » : le parcours est déjà envoyé.
- Vous n'avez pas le droit de supprimer le document.
Les pièges
- Pour remplacer le fichier d'un document plutôt que de le supprimer, modifiez-le :
PUT https://staging-api.docage.com/TransactionFiles/{id}, enmultipart/form-data, avec le nouveauFileToUpload— le document garde son identifiant et ses emplacements. - Un parcours sans document à signer ne s'envoie pas.
- Les anciennes formes de cette route,
TransactionFiles/BatchDeleteFromDbetTransactionFiles/BatchDelete/{id}, répondent encore ; l'identifiant de l'adresse y est ignoré, seule compte la liste du corps.