API MƏNBƏSİ

Görüş & Təqvim

Həkim və koltuq (kreslo) əsaslı planlaşdırma, ikiqat rezervasiya bloku, avtomatik xatırlatma və gözləmə siyahısı. Toqquşma verilənlər bazası səviyyəsində bloklanır.

Erkən Giriş Bütün API

Uçlar

10 uc

Bu mənbəyə aid uc nöqtələr. Hər uc, API açarının bağlı olduğu klinika verisi ilə məhduddur; yazma ucları Idempotency-Key başlığını dəstəkləyir.

GET /v1/appointments Randevuları tarix aralığına görə siyahılayır Bütün yetkili rollar

POST /v1/appointments Yeni randevu yaradır (toqquşma nəzarətli) admin · katib · həkim

POST /v1/appointments/{id}/status Randevu vəziyyətini dəyişir admin · katib · həkim

POST /v1/appointments/{id}/reschedule Randevunu yenidən planlaşdırır admin · katib · həkim

POST /v1/appointments/{id}/remind Randevu xatırlatması göndərir admin · katib · həkim

GET /v1/units Koltuq/vahidləri (kreslo/unit) siyahılayır Bütün yetkili rollar

GET /v1/doctors Həkimləri siyahılayır Bütün yetkili rollar

GET /v1/waitlist Gözləmə siyahısını gətirir Bütün yetkili rollar

POST /v1/waitlist Gözləmə siyahısına xəstə əlavə edir admin · katib · həkim

DELETE /v1/waitlist/{id} Gözləmə siyahısından çıxarır admin · katib · həkim

Nümunə İstifadə

Tarix aralığına görə randevuları gətir

Sorğu

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

Cavab

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

Bu mənbədə təhlükəsizlik

Təhlükəsizlik bir xüsusiyyət deyil, arxitekturanın özüdür. Bu mənbədə keçərli olan zəmanətlər:

İkiqat rezervasiya, exclusion constraint ilə verilənlər bazası səviyyəsində qeyri-mümkündür; tətbiq xətası olsa belə toqquşan randevu yazıla bilməz.

Eyni vaxtlı slot yarışı Redis paylanmış kilidi ilə önlənir; eyni slota iki sorğu eyni anda yaza bilməz.

Bütün randevu verisi klinikanıza izolyasiya olunub (RLS); vəziyyət dəyişiklikləri audit qeydinə işlənir.

Bütün təhlükəsizlik modeli →

Xəta Formatı

Xətalar ardıcıl bir zərf ilə qayıdır; kod maşına, mesaj istifadəçiyə yönəlikdir. Daxili xəta/stack heç vaxt sızdırılmır.

{
  "error": {
    "code": "validation_failed",
    "message": "Yanlış sahə: e-poçt"
  }
}

Digər Mənbələr

Xəstələr Odontoqram & Müalicə Tahsilat və Maliyyə Anbar Görüntüləmə Laboratoriya Lead & CRM Sağlamlıq Turizmi Hesabatlama & BI Webhooks Veri Ötürülməsi (Export API)

Erkən giriş istəyirsiniz?

API açıldıqda ilk siz xəbərdar olun.

Əlaqə Saxla