MAPAGKUKUNAN NG API

Pag-iiskedyul & Kalendaryo

Pagpaplano batay sa doktor at silya, pagharang sa double booking, awtomatikong paalala at waiting list. Ang banggaan ay hinaharangan sa antas ng database.

Maagang Access Buong API

Mga Endpoint

10 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/appointments Inililista ang mga appointment ayon sa saklaw ng petsa Lahat ng awtorisadong role

POST /v1/appointments Gumagawa ng bagong appointment (may kontrol sa banggaan) admin · sekretarya · doktor

POST /v1/appointments/{id}/status Binabago ang katayuan ng appointment admin · sekretarya · doktor

POST /v1/appointments/{id}/reschedule Muling ini-iskedyul ang appointment admin · sekretarya · doktor

POST /v1/appointments/{id}/remind Nagpapadala ng paalala ng appointment admin · sekretarya · doktor

GET /v1/units Inililista ang mga silya/unit Lahat ng awtorisadong role

GET /v1/doctors Inililista ang mga doktor Lahat ng awtorisadong role

GET /v1/waitlist Kinukuha ang waiting list Lahat ng awtorisadong role

POST /v1/waitlist Nagdaragdag ng pasyente sa waiting list admin · sekretarya · doktor

DELETE /v1/waitlist/{id} Inaalis mula sa waiting list admin · sekretarya · doktor

Halimbawang Paggamit

Kunin ang mga appointment ayon sa saklaw ng petsa

Request

curl https://api.udentiva.com/v1/appointments?from=2026-06-24&to=2026-06-25 \
  -H "Authorization: Bearer udk_live_xxx"

Sagot

HTTP/1.1 200 OK
[
  {
    "id": "a1b2...",
    "patient_id": "c0ffee00-...",
    "unit_id": "u-1",
    "starts_at": "2026-06-24T10:00:00Z",
    "ends_at": "2026-06-24T10:30:00Z",
    "status": "confirmed"
  }
]

Seguridad sa mapagkukunang ito

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

Ang double booking ay imposible sa antas ng database sa pamamagitan ng exclusion constraint; kahit may error sa aplikasyon, hindi maisusulat ang nagbabanggaang appointment.

Ang sabay-sabay na paligsahan sa slot ay pinipigilan ng distributed lock ng Redis; hindi makapagsusulat ang dalawang request sa parehong slot nang sabay.

Ang lahat ng datos ng appointment ay nakabukod sa inyong klinika (RLS); ang mga pagbabago sa katayuan ay naitatala sa audit record.

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 Odontogram & Paggamot Koleksyon at Pananalapi Stock Imaging Laboratoryo Lead & CRM Health Tourism Pag-uulat & BI Webhooks Paglipat ng Datos (Export API)

Gusto ninyo ba ng maagang access?

Maging una kayong makaalam kapag bukas na ang API.

Makipag-ugnayan