Skip to content

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.

GuideDeveloper
Required access
Rôle HDS_HEALTHCARE ou HDS_ADMIN pour enregistrer
Duration
10 min

This page has not been translated yet and is shown in French.

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_HEALTHCARE ou HDS_ADMIN. Pour consulter : HDS_HEALTHCARE, HDS_MEDICAL, HDS_PATIENT ou HDS_ADMIN.

Enregistrer le consentement

ChampObligatoireDescription
patientIdOuiIdentifiant du patient, par exemple l'externalId du coffre.
purposeOuiFinalité : par exemple storage, sharing, research.
scopeOuiPérimètre : par exemple all_documents, specific_document, specific_practitioner.
scopeDetailNonPrécision du périmètre : identifiant du document ou du praticien.
collectionMethodOuiMode de recueil : par exemple in_app, paper_scanned, verbal_recorded.
expiresAtNonDate 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 activeConsents de GET /api/hds/compliance/rgpd a augmenté. Voir Produire un rapport de conformité.

Voir aussi