RESSOURCE API

Odontogramme & Traitement

Schéma dentaire FDI, catalogue de services/actes, plan de traitement par phases et ordonnance. Les états dentaires sont conservés en append-only — l'historique n'est ni supprimé ni écrasé.

Accès anticipé Toute l'API

Points d'accès

14 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}/odontogram Récupère le schéma dentaire FDI courant Tous les rôles autorisés

POST /v1/patients/{id}/odontogram Ajoute un état dentaire (append-only) admin · praticien

GET /v1/patients/{id}/odontogram/{tooth}/history Récupère l'historique d'état d'une dent Tous les rôles autorisés

GET /v1/services Liste le catalogue de services/actes Tous les rôles autorisés

POST /v1/services Ajoute un poste de service admin

PUT /v1/services/{id} Met à jour un poste de service admin

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

POST /v1/patients/{id}/plans Crée un plan de traitement admin · praticien

GET /v1/plans/{id} Récupère le détail du plan de traitement Tous les rôles autorisés

POST /v1/plans/{id}/status Change le statut du plan admin · praticien

POST /v1/plans/{id}/items Ajoute une phase/un poste au plan admin · praticien

POST /v1/plan-items/{id}/status Change le statut d'un poste du plan admin · praticien

GET /v1/patients/{id}/prescriptions Liste les ordonnances Tous les rôles autorisés

POST /v1/patients/{id}/prescriptions Crée une ordonnance admin · praticien

Exemple d'usage

Ajouter un état dentaire (append-only)

Requête

curl -X POST https://api.udentiva.com/v1/patients/{id}/odontogram \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"tooth":"11","state":"caries","surface":"mesial"}'

Réponse

HTTP/1.1 201 Created
{
  "id": "st-77",
  "tooth": "11",
  "state": "caries",
  "recorded_at": "2026-06-24T09:10: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 enregistrements d'état dentaire sont append-only : chaque modification est ajoutée en nouvelle ligne, l'ancien enregistrement ne peut être modifié (intégrité de l'historique clinique).

La création de plan de traitement et d'ordonnance est réservée aux rôles admin/praticien ; la logique de prix et de phases est exécutée sur le serveur.

Tous les enregistrements sont isolés à votre clinique ; les calculs de prix des plans ne sont pas pris du client, ils sont effectués sur le serveur en numeric.

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 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