RESSOURCE API

Imagerie

Les radiographies et les photos cliniques sont rattachées au dossier patient. Les fichiers sont conservés dans un stockage d'objets compatible S3 ; jamais dans la base de données.

Accès anticipé Toute l'API

Points d'accès

3 point d'accès

Points d'accès de cette ressource. Chaque point est limité aux données du cabinet auquel la clé API est rattachée ; les points d'écriture prennent en charge l'en-tête Idempotency-Key.

GET /v1/patients/{id}/images Liste les images du patient (radiographies/photos) Tous les rôles autorisés

POST /v1/patients/{id}/images Téléverse une image (S3, stream/presigned) admin · praticien · secrétaire

GET /v1/images/{id}/raw Télécharge le fichier image (presigned) Tous les rôles autorisés

Exemple d'usage

Lister les images du patient

Requête

curl https://api.udentiva.com/v1/patients/{id}/images \
  -H "Authorization: Bearer udk_live_xxx"

Réponse

HTTP/1.1 200 OK
[
  {
    "id": "img-55",
    "kind": "panoramic",
    "url": "https://s3.../signed?expires=...",
    "created_at": "2026-06-24T09:20:00Z"
  }
]

Sécurité de cette ressource

La sécurité n'est pas une fonctionnalité, c'est l'architecture elle-même. Les garanties applicables à cette ressource :

Les fichiers volumineux (radiographies) ne sont pas écrits sur le disque du BFF ; ils sont envoyés directement vers S3 en stream/presigned.

L'accès aux fichiers bruts est fourni via un lien signé à durée limitée (presigned) ; même en cas de fuite du lien, celui-ci expire.

Toutes les images sont isolées au patient et à la clinique (RLS) ; aucune clinique non autorisée ne peut y accéder.

Tout le modèle de sécurité →

Format d'erreur

Les erreurs sont renvoyées dans une enveloppe cohérente ; le code s'adresse à la machine, le message à l'utilisateur. Aucune erreur interne / trace de pile n'est jamais divulguée.

{
  "error": {
    "code": "validation_failed",
    "message": "Champ invalide : e-mail"
  }
}

Autres ressources

Patients Rendez-vous & Agenda Odontogramme & Traitement Encaissement & Finance Stock Laboratoire Lead & CRM Tourisme médical Reporting & BI Webhooks Transfert de Données (Export API)

Souhaitez-vous un accès anticipé ?

Soyez le premier informé dès l'ouverture de l'API.

Contacter