RESSOURCE API

Patients

Dossier patient : informations démographiques, anamnèse/allergies, antécédents médicaux et documents. Chaque enregistrement est isolé à votre clinique ; la suppression est un archivage réversible (pas de hard-delete).

Accès anticipé Toute l'API

Points d'accès

9 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 Récupère la liste des patients paginée Tous les rôles autorisés

POST /v1/patients Crée un nouvel enregistrement patient admin · secrétaire · praticien

GET /v1/patients/{id} Récupère le détail d'un seul patient Tous les rôles autorisés

PUT /v1/patients/{id} Met à jour les informations du patient admin · secrétaire · praticien

DELETE /v1/patients/{id} Archive le patient (soft-delete) admin

GET /v1/patients/{id}/medical Liste l'anamnèse, les allergies et les antécédents médicaux Tous les rôles autorisés

POST /v1/patients/{id}/medical Ajoute un enregistrement médical/d'anamnèse admin · praticien

GET /v1/patients/{id}/documents Liste les documents du patient Tous les rôles autorisés

POST /v1/patients/{id}/documents Ajoute un document au patient admin · secrétaire

Exemple d'usage

Créer un nouveau patient

Requête

curl -X POST https://api.udentiva.com/v1/patients \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Idempotency-Key: 9f1c2e7a-..." \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Ayse","last_name":"Yilmaz","phone":"+90555..."}'

Réponse

HTTP/1.1 201 Created
{
  "id": "c0ffee00-1234-...",
  "first_name": "Ayse",
  "last_name": "Yilmaz",
  "phone": "+90555...",
  "created_at": "2026-06-24T09:00: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 :

Isolation des données : toutes les requêtes patient sont limitées au niveau des lignes (RLS) à la clinique à laquelle la clé est rattachée ; le patient d'une autre clinique n'est jamais renvoyé.

Autorisation basée sur les rôles : création/mise à jour par admin, secrétaire ou praticien ; suppression réservée à l'admin. L'autorisation est imposée au niveau de la couche API.

Les données sensibles (TCKN, données de santé) sont masquées et ne sont pas inscrites en clair au journal d'audit.

Suppression = soft-delete (deleted_at) ; l'enregistrement est anonymisé et non supprimé physiquement (conforme KVKK).

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

Rendez-vous & Agenda Odontogramme & Traitement Encaissement & Finance Stock Imagerie 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