RESSOURCE API

Webhooks

À mesure que des événements se produisent dans votre clinique, une notification signée est envoyée à l'adresse que vous avez enregistrée ; vous maintenez votre propre système à jour en temps réel.

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/webhooks Liste les abonnements webhook enregistrés admin

POST /v1/webhooks Enregistre un webhook pour la notification d'événements admin

DELETE /v1/webhooks/{id} Supprime l'abonnement webhook admin

Exemple d'usage

Enregistrer un webhook

Requête

curl -X POST https://api.udentiva.com/v1/webhooks \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://siz.example/hook","events":["payment.created"]}'

Réponse

HTTP/1.1 201 Created
{
  "id": "wh-1",
  "url": "https://siz.example/hook",
  "events": ["payment.created"],
  "secret": "whsec_xxx"
}

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 :

Chaque notification est signée avec une clé secrète partagée (HMAC) ; en vérifiant la signature, vous confirmez que la requête provient réellement d'UDENTIVA.

Renvoi sécurisé : chaque événement possède un identifiant unique ; vous pouvez filtrer les livraisons en double à partir de l'identifiant (consommation idempotente).

Les abonnements webhook sont isolés à votre clinique ; vous ne recevez que vos propres événements.

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 Imagerie Laboratoire Lead & CRM Tourisme médical Reporting & BI Transfert de Données (Export API)

Souhaitez-vous un accès anticipé ?

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

Contacter