Recueillir un consentement patient
Consignez dans le coffre le consentement d'un patient, sa finalité, son périmètre et son mode de recueil, puis consultez-le.
GuideDéveloppeur
- Accès requis
- Rôle HDS_HEALTHCARE ou HDS_ADMIN pour enregistrer
- Durée
- 10 min
Le module conserve la preuve du consentement du patient : qui l'a recueilli, quand, comment et pour quelle finalité. Votre application recueille l'accord ; le module le consigne dans le coffre et l'inscrit au journal d'audit.
Avant de commencer
- Le coffre du patient existe. Voir Gérer les coffres.
- Le patient a donné son accord dans votre application, sur papier ou à l'oral.
- Pour enregistrer :
HDS_HEALTHCAREouHDS_ADMIN. Pour consulter :HDS_HEALTHCARE,HDS_MEDICAL,HDS_PATIENTouHDS_ADMIN.
Enregistrer le consentement
| Champ | Obligatoire | Description |
|---|---|---|
patientId | Oui | Identifiant du patient, par exemple l'externalId du coffre. |
purpose | Oui | Finalité : par exemple storage, sharing, research. |
scope | Oui | Périmètre : par exemple all_documents, specific_document, specific_practitioner. |
scopeDetail | Non | Précision du périmètre : identifiant du document ou du praticien. |
collectionMethod | Oui | Mode de recueil : par exemple in_app, paper_scanned, verbal_recorded. |
expiresAt | Non | Date de fin de validité convenue, ISO 8601. |
Bash
curl -X POST "https://api.wakastart.app/api/hds/vaults/vlt_a1B2c3D4/consents" \
-H "Authorization: Bearer $USER_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"patientId": "PAT-000123",
"purpose": "sharing",
"scope": "specific_practitioner",
"scopeDetail": "2c9d7e41-5a8b-4f60-9e3d-1b7a6c5d4e21",
"collectionMethod": "in_app"
}'TypeScript
const response = await fetch(
"https://api.wakastart.app/api/hds/vaults/vlt_a1B2c3D4/consents",
{
method: "POST",
headers: { Authorization: `Bearer ${process.env.USER_TOKEN}`, "Content-Type": "application/json" },
body: JSON.stringify({
patientId: "PAT-000123",
purpose: "sharing",
scope: "specific_practitioner",
scopeDetail: "2c9d7e41-5a8b-4f60-9e3d-1b7a6c5d4e21",
collectionMethod: "in_app",
}),
},
);
console.log(response.status, await response.json());Réponse attendue (201 Created) :
JSON
{
"consentId": "cst_Fg8Hj2Kl",
"vaultId": "vlt_a1B2c3D4",
"patientId": "PAT-000123",
"purpose": "sharing",
"scope": "specific_practitioner",
"scopeDetail": "2c9d7e41-5a8b-4f60-9e3d-1b7a6c5d4e21",
"status": "ACTIVE",
"collectedAt": "2026-10-23T11:30:00.000Z",
"collectedBy": "8f14e45f-ceea-467f-a0e6-2d2d3a7c1b11",
"collectionMethod": "in_app",
"expiresAt": null,
"withdrawnAt": null,
"withdrawnBy": null,
"withdrawalConsequence": null,
"createdAt": "2026-10-23T11:30:00.000Z",
"updatedAt": "2026-10-23T11:30:00.000Z"
}Utilisez des valeurs stables pour purpose, scope et collectionMethod : elles servent à filtrer et à produire vos rapports.
Consulter les consentements d'un coffre
Bash
curl "https://api.wakastart.app/api/hds/vaults/vlt_a1B2c3D4/consents?status=ACTIVE" \
-H "Authorization: Bearer $USER_TOKEN"Filtres : patientId, status (ACTIVE, WITHDRAWN, EXPIRED), limit. Pour un consentement précis : GET /api/hds/vaults/{vaultId}/consents/{consentId}.
Vérifier le résultat
- Le consentement apparaît dans la liste du coffre avec le statut
ACTIVE. - Le journal d'audit contient
CONSENT_CREATED. - L'indicateur
activeConsentsdeGET /api/hds/compliance/rgpda augmenté. Voir Produire un rapport de conformité.