Aller au contenu

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
Voir en Markdown

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_PATIENT ou HDS_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.json
TypeScript
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

  • documents liste 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.

Voir aussi