Aller au contenu

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

Démarrage rapideDéveloppeur
Durée
10 min
Voir en Markdown

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.
  • Un utilisateur de test porte le rôle HDS_HEALTHCARE. Voir Attribuer les rôles.
  • Vous disposez de son jeton d'accès Keycloak, émis pour votre application (connexion via Discovery). Voir 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"

Attention

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.

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