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é.
- Durée
- 10 min
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.
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
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) :
{
"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 »
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
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) :
{
"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
curl "$HDS_API/vaults/vlt_a1B2c3D4/documents" \
-H "Authorization: Bearer $USER_TOKEN"La réponse contient le document dans data, avec son folderId :
{
"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 }
}