Retirer des participants d'un brouillon
Supprimer un ou plusieurs participants d'un parcours qui n'est pas encore envoyé.
DELETE https://staging-api.docage.com/TransactionMembers/BatchDelete
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9…
Content-Type: application/json
["dddddddd-0000-4000-8000-000000000004", "dddddddd-0000-4000-8000-000000000014"]curl -X DELETE "https://staging-api.docage.com/TransactionMembers/BatchDelete" \
-H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9…" \
-H "Content-Type: application/json" \
-d '["dddddddd-0000-4000-8000-000000000004", "dddddddd-0000-4000-8000-000000000014"]'using HttpClient client = new();
using HttpRequestMessage request = new(HttpMethod.Delete, "https://staging-api.docage.com/TransactionMembers/BatchDelete");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", token);
request.Content = new StringContent("""
[
"dddddddd-0000-4000-8000-000000000004",
"dddddddd-0000-4000-8000-000000000014"
]
""", 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/TransactionMembers/BatchDelete", {
method: "DELETE",
headers: {
Authorization: `Bearer ${token}`,
"Content-Type": "application/json"
},
body: JSON.stringify(["dddddddd-0000-4000-8000-000000000004", "dddddddd-0000-4000-8000-000000000014"])
});
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 participants, d'un ou de plusieurs parcours. 200, sans corps : les participants sont
supprimés définitivement, avec leurs actions et leurs emplacements de signature.
Les refus
Chaque participant est traité à part ; les erreurs sont réunies dans un seul 400, et les autres participants sont supprimés quand
même :
- « Le participant … est introuvable » ;
- vous n'avez pas le droit de le supprimer ;
- son parcours est déjà envoyé : un parcours en cours ou terminé ne perd pas de participant.
Les pièges
- Un parcours envoyé ne perd plus de participant : annulez-le (Annuler un parcours), puis créez-en un nouveau.
- Les observateurs se retirent par
DELETE https://staging-api.docage.com/TransactionObservers/BatchDelete, de la même façon. - Un parcours sans participant ne s'envoie pas : ajoutez-en un avant le lancement — Ajouter un participant.