# Démarrage rapide : créer un coffre patient

> Créez un coffre patient, déposez-y un compte rendu et retrouvez-le, avec cURL et le jeton d'un professionnel de santé.

Vous allez créer le coffre d'un patient, y déposer un document et vérifier qu'il est bien rattaché au coffre. Les appels partent de votre terminal, comme ils partiraient du serveur de votre wakapp.

## Ce que vous allez construire

Un coffre de type `PATIENT` dans l'espace HDS de votre client, contenant un document chiffré, visible dans la liste des documents du coffre.

## Avant de commencer

- [ ] Le module HDS est actif pour votre application. Voir [Activer le module](/v1.0/hds/activer-le-module).
- [ ] Un utilisateur de test porte le rôle `HDS_HEALTHCARE`. Voir [Attribuer les rôles](/v1.0/hds/attribuer-les-roles).
- [ ] Vous disposez de son jeton d'accès Keycloak, émis pour votre application (connexion via Discovery). Voir [Authentification](/v1.0/authentification).
- [ ] Un fichier de test sans donnée réelle, par exemple `compte-rendu-test.pdf`.

```bash
export USER_TOKEN="eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.exemple"
export HDS_API="https://api.wakastart.app/api/hds"
```

:::warning
Les clés API `sk_…` ne portent pas de rôle HDS : le module HDS s'appelle toujours avec le jeton d'un utilisateur. N'utilisez que des données fictives pendant vos essais.
:::

## 1. Créer le coffre du patient

```bash
curl -X POST "$HDS_API/vaults" \
  -H "Authorization: Bearer $USER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "PATIENT",
    "label": "Dossier de Marie Exemple",
    "patient": {
      "externalId": "PAT-000123",
      "firstName": "Marie",
      "lastName": "Exemple",
      "birthDate": "1980-04-12"
    },
    "defaultFolders": ["Comptes rendus", "Ordonnances"]
  }'
```

Réponse attendue (`201 Created`) :

```json
{
  "vaultId": "vlt_a1B2c3D4",
  "type": "PATIENT",
  "status": "ACTIVE",
  "label": "Dossier de Marie Exemple",
  "ownerId": "8f14e45f-ceea-467f-a0e6-2d2d3a7c1b11",
  "ownerTeamId": null,
  "patient": {
    "externalId": "PAT-000123",
    "firstName": "Marie",
    "lastName": "Exemple",
    "birthDate": "1980-04-12T00:00:00.000Z"
  },
  "pseudonymizedPatientId": null,
  "storageUsedBytes": 0,
  "documentCount": 0,
  "retentionPolicy": "STANDARD",
  "expiresAt": null,
  "createdAt": "2026-10-23T10:02:17.441Z",
  "updatedAt": "2026-10-23T10:02:17.441Z"
}
```

Notez `vaultId`. `ownerId` est l'identifiant Keycloak de l'utilisateur qui a créé le coffre : il en est le propriétaire.

## 2. Trouver le dossier « Comptes rendus »

```bash
curl "$HDS_API/vaults/vlt_a1B2c3D4/folders" \
  -H "Authorization: Bearer $USER_TOKEN"
```

La réponse liste les deux dossiers créés à l'étape 1. Notez le `folderId` de « Comptes rendus », par exemple `fld_Xy7Kp2Qa`.

## 3. Déposer un document

```bash
curl -X POST "$HDS_API/vaults/vlt_a1B2c3D4/documents" \
  -H "Authorization: Bearer $USER_TOKEN" \
  -F "file=@compte-rendu-test.pdf" \
  -F "folderId=fld_Xy7Kp2Qa" \
  -F "comment=Consultation du 23 octobre"
```

Réponse attendue (`201 Created`) :

```json
{
  "docId": "doc_Q7w8E9r0",
  "vaultId": "vlt_a1B2c3D4",
  "originalFilename": "compte-rendu-test.pdf",
  "mimeType": "application/pdf",
  "sizeBytes": 184320,
  "status": "QUARANTINED",
  "currentVersion": 1,
  "antivirusStatus": "QUARANTINED",
  "createdAt": "2026-10-23T10:04:51.009Z"
}
```

Le fichier est chiffré et rattaché au coffre. Les valeurs de `status` et d'`antivirusStatus` sont décrites dans la [référence](/v1.0/hds/reference#statuts-dun-document).

## 4. Vérifier que ça marche

```bash
curl "$HDS_API/vaults/vlt_a1B2c3D4/documents" \
  -H "Authorization: Bearer $USER_TOKEN"
```

La réponse contient le document dans `data`, avec son `folderId` :

```json
{
  "data": [
    {
      "docId": "doc_Q7w8E9r0",
      "vaultId": "vlt_a1B2c3D4",
      "folderId": "fld_Xy7Kp2Qa",
      "originalFilename": "compte-rendu-test.pdf",
      "mimeType": "application/pdf",
      "sizeBytes": 184320,
      "status": "QUARANTINED",
      "currentVersion": 1,
      "tags": [],
      "antivirusStatus": "QUARANTINED",
      "uploadedBy": "8f14e45f-ceea-467f-a0e6-2d2d3a7c1b11",
      "legalHold": false,
      "createdAt": "2026-10-23T10:04:51.009Z",
      "updatedAt": "2026-10-23T10:04:51.009Z"
    }
  ],
  "meta": { "limit": 20, "hasMore": false }
}
```

## Étapes suivantes

::::cards{cols=3}
:::card{title="Modèle de données" href="/v1.0/hds/modele-de-donnees" icon="Network"}
Comprendre coffres, documents, partages et consentements.
:::
:::card{title="Partager un coffre" href="/v1.0/hds/partager-un-coffre" icon="Share2"}
Ouvrir le coffre au patient ou à un autre soignant.
:::
:::card{title="Liste de contrôle" href="/v1.0/hds/liste-de-controle" icon="ListChecks"}
Tout vérifier avant d'héberger de vraies données.
:::
::::
