Exporter les données d'un coffre
Produisez l'export structuré d'un coffre pour répondre à une demande de portabilité d'un patient (RGPD, article 20).
GuideDéveloppeur
- Accès requis
- Rôle HDS_PATIENT ou HDS_ADMIN, avec accès au coffre
- Durée
- 5 min
L'export d'un coffre rassemble, en un seul JSON, la description du coffre, la liste de ses documents, ses consentements et ses partages actifs. Il sert de base à la réponse à une demande d'accès ou de portabilité.
Avant de commencer
- L'utilisateur porte
HDS_PATIENTouHDS_ADMIN. - Il est propriétaire du coffre ou destinataire d'un partage actif. Pour qu'un patient exporte son dossier, partagez-lui d'abord le coffre. Voir Partager un coffre.
Exporter le coffre
Bash
curl "https://api.wakastart.app/api/hds/vaults/vlt_a1B2c3D4/export" \
-H "Authorization: Bearer $USER_TOKEN" \
-o export-vlt_a1B2c3D4.jsonTypeScript
import { writeFile } from "node:fs/promises";
const response = await fetch("https://api.wakastart.app/api/hds/vaults/vlt_a1B2c3D4/export", {
headers: { Authorization: `Bearer ${process.env.USER_TOKEN}` },
});
if (!response.ok) throw new Error(`${response.status}`);
await writeFile("export-vlt_a1B2c3D4.json", JSON.stringify(await response.json(), null, 2));Réponse attendue (extrait) :
JSON
{
"exportVersion": "1.0",
"exportedAt": "2026-10-23T12:00:00.000Z",
"vault": {
"vaultId": "vlt_a1B2c3D4",
"type": "PATIENT",
"status": "ACTIVE",
"label": "Dossier de Marie Exemple",
"retentionPolicy": "STANDARD",
"storageUsedBytes": 280832,
"documentCount": 2,
"createdAt": "2026-10-23T10:02:17.441Z",
"updatedAt": "2026-10-23T10:31:44.130Z"
},
"documents": [
{
"docId": "doc_Pz3Vb6Nc",
"folderId": "fld_Lm4Rt8Ws",
"originalFilename": "ordonnance-2026-10-23.pdf",
"mimeType": "application/pdf",
"sizeBytes": 96512,
"status": "QUARANTINED",
"currentVersion": 1,
"tags": [],
"uploadedBy": "8f14e45f-ceea-467f-a0e6-2d2d3a7c1b11",
"legalHold": false,
"createdAt": "2026-10-23T10:31:44.120Z",
"updatedAt": "2026-10-23T10:31:44.120Z"
}
],
"consents": [],
"shares": []
}L'export contient les métadonnées des documents, pas leur contenu. Les documents supprimés n'y figurent pas.
Vérifier le résultat
documentsliste les documents non supprimés du coffre.- Le journal d'audit contient
VAULT_EXPORTED, avec le nombre de documents, de consentements et de partages exportés.