SUMBER API

Penjadualan & Kalendar

Penjadualan berasaskan doktor dan kerusi, halangan tempahan berganda, peringatan automatik dan senarai menunggu. Pertindihan dihalang pada peringkat pangkalan data.

Akses Awal Semua API

Titik Akhir

10 titik akhir

Titik akhir bagi sumber ini. Setiap titik akhir terhad kepada data klinik yang dikaitkan dengan kunci API; titik akhir penulisan menyokong pengepala Idempotency-Key.

GET /v1/appointments Menyenaraikan temu janji mengikut julat tarikh Semua peranan yang dibenarkan

POST /v1/appointments Mencipta temu janji baharu (dengan kawalan pertindihan) admin · setiausaha · doktor

POST /v1/appointments/{id}/status Menukar status temu janji admin · setiausaha · doktor

POST /v1/appointments/{id}/reschedule Menjadualkan semula temu janji admin · setiausaha · doktor

POST /v1/appointments/{id}/remind Menghantar peringatan temu janji admin · setiausaha · doktor

GET /v1/units Menyenaraikan kerusi/unit Semua peranan yang dibenarkan

GET /v1/doctors Menyenaraikan doktor Semua peranan yang dibenarkan

GET /v1/waitlist Mendapatkan senarai menunggu Semua peranan yang dibenarkan

POST /v1/waitlist Menambah pesakit ke senarai menunggu admin · setiausaha · doktor

DELETE /v1/waitlist/{id} Mengeluarkan daripada senarai menunggu admin · setiausaha · doktor

Contoh Penggunaan

Tarik temu janji mengikut julat tarikh

Permintaan

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

Respons

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

Keselamatan dalam sumber ini

Keselamatan bukanlah satu ciri, tetapi seni bina itu sendiri. Jaminan yang terpakai dalam sumber ini:

Tempahan berganda adalah mustahil pada peringkat pangkalan data dengan exclusion constraint; walaupun berlaku ralat aplikasi, temu janji yang bertindih tidak boleh ditulis.

Perlumbaan slot serentak dihalang dengan kunci teragih Redis; dua permintaan tidak boleh menulis ke slot yang sama pada masa yang sama.

Semua data temu janji terpencil kepada klinik anda (RLS); perubahan status direkodkan dalam rekod audit.

Seluruh model keselamatan →

Format Ralat

Ralat dipulangkan dengan sampul yang tekal; kod ditujukan kepada mesin, mesej kepada pengguna. Ralat dalaman/stack tidak sekali-kali dibocorkan.

{
  "error": {
    "code": "validation_failed",
    "message": "Medan tidak sah: e-mel"
  }
}

Sumber Lain

Pesakit Odontogram & Rawatan Kutipan & Kewangan Stok Pengimejan Makmal Lead & CRM Pelancongan Kesihatan Pelaporan & BI Webhooks Pemindahan Data (Export API)

Mahukan akses awal?

Jadilah orang pertama yang tahu apabila API dibuka.

Hubungi kami