# Résoudre les problèmes HDS

> Les erreurs rencontrées en intégrant le module de données de santé, avec leur cause et leur solution.

Cette page part de ce que vous observez à l'appel de `/api/hds/*`. Les messages sont cités tels que l'API les renvoie.

## Symptômes

- [Tous les appels renvoient 403 faute de rôle HDS](#tous-les-appels-renvoient-403-faute-de-rôle-hds)
- [Une opération renvoie 403 alors que l'utilisateur a un rôle HDS](#une-opération-renvoie-403-alors-que-lutilisateur-a-un-rôle-hds)
- [Un coffre renvoie 404 alors qu'il existe](#un-coffre-renvoie-404-alors-quil-existe)
- [La création de coffre renvoie 400 car l'espace est inactif](#la-création-de-coffre-renvoie-400-car-lespace-est-inactif)
- [Le dépôt renvoie 413](#le-dépôt-renvoie-413)
- [Les appels renvoient 503](#les-appels-renvoient-503)
- [Un patient ne voit pas son dossier](#un-patient-ne-voit-pas-son-dossier)
- [L'attribution d'un rôle renvoie 403](#lattribution-dun-rôle-renvoie-403)

## Tous les appels renvoient 403 faute de rôle HDS

**Cause** : l'appel ne porte aucun rôle HDS. Message : `Rôle(s) HDS requis: HDS_ADMIN, HDS_HEALTHCARE, HDS_MEDICAL, HDS_PATIENT, HDS_STORAGE, HDS_DELETE (mode: any)`.

**Solution** :
1. Vérifiez que vous appelez avec `Authorization: Bearer <jeton de l'utilisateur>`, et non avec une clé `sk_…`, qui ne porte jamais de rôle HDS.
2. Vérifiez que l'utilisateur a des rôles HDS : lisez `hdsRoles` dans `/me`. Sinon, voir [Attribuer les rôles](/v1.0/hds/attribuer-les-roles).
3. Si les rôles viennent d'être attribués, obtenez un nouveau jeton.

## Une opération renvoie 403 alors que l'utilisateur a un rôle HDS

**Cause** : l'utilisateur a des rôles HDS, mais aucun ne permet cette opération. Exemple : un `HDS_MEDICAL` qui tente de déposer un document, un `HDS_HEALTHCARE` qui lit le journal d'audit.

**Solution** : consultez la [matrice des permissions](/v1.0/hds/reference#permissions-par-rôle) et ajoutez le rôle adapté.

## Un coffre renvoie 404 alors qu'il existe

**Cause** : l'utilisateur n'en est ni propriétaire, ni destinataire d'un partage actif. Le module répond `404` `Vault not found: vlt_…` pour ne pas révéler l'existence du coffre. C'est aussi vrai pour un `HDS_ADMIN`.

**Solution** : demandez au propriétaire de partager le coffre. Voir [Partager un coffre](/v1.0/hds/partager-un-coffre). Si le partage a été révoqué par une revue d'accès, recréez-le.

**Pour vérifier** : `GET /api/hds/shares?vaultId=vlt_…` avec le jeton du propriétaire.

## La création de coffre renvoie 400 car l'espace est inactif

**Cause** : l'espace HDS du client de l'utilisateur n'existe pas ou n'est pas actif.

**Solution** :
1. Vérifiez que le module est activé pour l'application et que le client y est rattaché. Voir [Activer le module](/v1.0/hds/activer-le-module).
2. Un administrateur HDS vérifie l'espace avec `GET /api/hds/networks/{WID du client}`.

## Le dépôt renvoie 413

**Cause** : `File too large` si le fichier dépasse 100 Mo ; `Storage quota exceeded` si le quota de stockage de l'espace est atteint.

**Solution** : pour un fichier trop gros, demandez une version plus légère. Pour le quota, supprimez les documents inutiles (purgés 30 jours plus tard) ou contactez Wakastart pour l'augmenter.

## Les appels renvoient 503

**Cause** : pour une application HDS, l'API refuse tout appel tant qu'elle ne peut pas vérifier que le jeton n'a pas été révoqué. Ce refus protège les données en cas d'incident.

**Solution** : réessayez après quelques secondes, avec un délai croissant. Si l'erreur persiste plus de quelques minutes, contactez le support.

## Un patient ne voit pas son dossier

**Cause** : le coffre appartient au professionnel qui l'a créé. Le rôle `HDS_PATIENT` ne relie pas à lui seul un patient à son coffre.

**Solution** : partagez le coffre avec l'identifiant Keycloak du patient. Voir [Partager un coffre](/v1.0/hds/partager-un-coffre).

## L'attribution d'un rôle renvoie 403

**Cause** : vous tentez d'attribuer un rôle HDS que vous ne possédez pas. Message : `Cannot assign hdsRole HDS_ADMIN: caller does not possess this role`.

**Solution** : demandez à un administrateur qui possède ce rôle de l'attribuer.

## Toujours bloqué ?

Contactez le support Wakastart avec :
- l'identifiant de la ressource concernée (`vlt_…`, `doc_…`, `shr_…`) ;
- l'heure de l'appel, la méthode, le chemin et le code HTTP ;
- le corps de la réponse d'erreur.

N'envoyez jamais de jeton, de document ni de donnée de patient au support.
