# 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.

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](/v1.0/hds/gerer-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

| 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. |

::::tabs{sync="lang"}
:::tab{label="cURL"}
```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"
  }'
```
:::
:::tab{label="TypeScript"}
```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é](/v1.0/hds/produire-un-rapport-de-conformite).

## Voir aussi

- [Responsabilités du client](/v1.0/hds/responsabilites-du-client)
- [Référence : objet consentement](/v1.0/hds/reference#consentement)
