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
- Une opération renvoie 403 alors que l'utilisateur a un rôle HDS
- Un coffre renvoie 404 alors qu'il existe
- La création de coffre renvoie 400 car l'espace est inactif
- Le dépôt renvoie 413
- Les appels renvoient 503
- Un patient ne voit pas son dossier
- L'attribution d'un 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 :
- 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. - Vérifiez que l'utilisateur a des rôles HDS : lisez
hdsRolesdans/me. Sinon, voir Attribuer les rôles. - 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 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. 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 :
- Vérifiez que le module est activé pour l'application et que le client y est rattaché. Voir Activer le module.
- 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.
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.