Partager un coffre
Ouvrez un coffre à un autre utilisateur, par exemple le patient ou un confrère, consultez les partages et révoquez-les.
- Required access
- Rôle HDS_HEALTHCARE ou HDS_ADMIN pour partager ; HDS_DELETE ou HDS_ADMIN pour révoquer
- Duration
- 10 min
This page has not been translated yet and is shown in French.
Un partage donne à un utilisateur l'accès à un coffre qu'il ne possède pas : il le voit dans sa liste et y fait ce que ses rôles HDS permettent. C'est aussi le moyen d'ouvrir son propre dossier à un patient.
Avant de commencer
- Le coffre existe. Voir Gérer les coffres.
- Vous connaissez l'identifiant Keycloak du destinataire : le
subde son jeton, que votre application obtient par/meou à sa connexion. - Le destinataire porte un rôle HDS adapté, par exemple
HDS_PATIENTouHDS_MEDICAL. Voir Attribuer les rôles. - Vous êtes propriétaire du coffre et portez le rôle
HDS_HEALTHCAREouHDS_ADMIN.
Créer un partage
curl -X POST "https://api.wakastart.app/api/hds/shares" \
-H "Authorization: Bearer $USER_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"vaultId": "vlt_a1B2c3D4",
"targetUserId": "2c9d7e41-5a8b-4f60-9e3d-1b7a6c5d4e21",
"level": "READ"
}'export async function shareVault(userToken: string, vaultId: string, recipientSub: string) {
const response = await fetch("https://api.wakastart.app/api/hds/shares", {
method: "POST",
headers: { Authorization: `Bearer ${userToken}`, "Content-Type": "application/json" },
body: JSON.stringify({ vaultId, targetUserId: recipientSub, level: "READ" }),
});
if (response.status !== 201) throw new Error(`${response.status} ${await response.text()}`);
return (await response.json()) as { shareId: string; active: boolean };
}Réponse attendue (201 Created) :
{
"shareId": "shr_Wq2Ez5Rt",
"vaultId": "vlt_a1B2c3D4",
"targetUserId": "2c9d7e41-5a8b-4f60-9e3d-1b7a6c5d4e21",
"targetTeamId": null,
"targetRole": null,
"level": "READ",
"grantedBy": "8f14e45f-ceea-467f-a0e6-2d2d3a7c1b11",
"expiresAt": null,
"active": true,
"revokedAt": null,
"revokedBy": null,
"createdAt": "2026-10-23T11:15:30.200Z",
"updatedAt": "2026-10-23T11:15:30.200Z"
}level vaut READ, READ_WRITE ou FULL_CONTROL et consigne le niveau d'accès que vous accordez. Les opérations permises au destinataire restent fixées par ses rôles HDS.
Consulter les partages
curl "https://api.wakastart.app/api/hds/shares?vaultId=vlt_a1B2c3D4&active=true" \
-H "Authorization: Bearer $USER_TOKEN"La liste contient les partages que vous avez accordés et ceux dont vous êtes le destinataire. Filtres : vaultId, targetUserId, active (true ou false), limit (20 par défaut, 100 au plus).
Révoquer un partage
Seul l'auteur du partage le révoque, avec le rôle HDS_DELETE ou HDS_ADMIN.
curl -X DELETE "https://api.wakastart.app/api/hds/shares/shr_Wq2Ez5Rt" \
-H "Authorization: Bearer $USER_TOKEN"La réponse renvoie le partage avec "active": false, revokedAt et revokedBy. Le destinataire perd l'accès au coffre immédiatement.
Vérifier le résultat
- Avec le jeton du destinataire, appelez
GET /api/hds/vaults: le coffre partagé figure dans la liste. - Après révocation, la même requête ne le renvoie plus, et
GET /api/hds/vaults/vlt_a1B2c3D4répond404.
Dépannage
400At least one target must be specified: …: renseigneztargetUserId.403Insufficient HDS permissions for this operation: vous n'avez niHDS_HEALTHCAREniHDS_ADMIN.403You must be the vault owner or have an admin role to create shares: vous n'êtes pas propriétaire du coffre.404Share not found: …à la révocation : vous n'êtes pas l'auteur de ce partage.