MAPAGKUKUNAN NG API

Webhooks

Habang nangyayari ang mga event sa inyong klinika, isang naka-sign na notification ang ipinapadala sa inyong naka-rehistrong address; pinapananatili ninyong napapanahon ang sarili ninyong sistema.

Maagang Access Buong API

Mga Endpoint

3 endpoint

Ang mga endpoint na nauukol sa mapagkukunang ito. Bawat endpoint ay limitado sa datos ng klinikang naka-ugnay sa API key; ang mga write endpoint ay sumusuporta sa Idempotency-Key header.

GET /v1/webhooks Inililista ang mga naka-rehistrong webhook subscription admin

POST /v1/webhooks Nagrerehistro ng webhook para sa notification ng event admin

DELETE /v1/webhooks/{id} Binubura ang webhook subscription admin

Halimbawang Paggamit

Magrehistro ng webhook

Request

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"]}'

Sagot

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

Seguridad sa mapagkukunang ito

Ang seguridad ay hindi isang feature, kundi ang arkitektura mismo. Ang mga garantiyang may bisa sa mapagkukunang ito:

Bawat notification ay naka-sign gamit ang shared secret key (HMAC); sa pag-verify ng signature ay makukumpirma ninyong tunay na galing sa UDENTIVA ang request.

Ligtas sa muling paghahatid: bawat event ay may natatanging identity; maaari ninyong alisin ang duplicate delivery gamit ang identity (idempotent na pagtanggap).

Ang mga webhook subscription ay nakabukod sa inyong klinika; ang sarili ninyong mga event lamang ang tinatanggap ninyo.

Buong modelo ng seguridad →

Format ng Error

Ang mga error ay ibinabalik sa isang tugmang envelope; ang code ay para sa makina, ang mensahe ay para sa user. Ang panloob na error/stack ay hindi kailanman tumatagas.

{
  "error": {
    "code": "validation_failed",
    "message": "Di-wastong field: email"
  }
}

Iba pang Mapagkukunan

Mga Pasyente Pag-iiskedyul & Kalendaryo Odontogram & Paggamot Koleksyon at Pananalapi Stock Imaging Laboratoryo Lead & CRM Health Tourism Pag-uulat & BI Paglipat ng Datos (Export API)

Gusto ninyo ba ng maagang access?

Maging una kayong makaalam kapag bukas na ang API.

Makipag-ugnayan