API MƏNBƏSİ

Xəstələr

Xəstə faylı: demoqrafik məlumat, anamnez/allergiya, tibbi keçmiş və sənədlər. Hər qeyd klinikanıza izolyasiya olunub; silmə əməliyyatı geri qaytarıla bilən arxivləşdirmədir (hard-delete yoxdur).

Erkən Giriş Bütün API

Uçlar

9 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/patients Xəstə siyahısını səhifələnmiş gətirir Bütün yetkili rollar

POST /v1/patients Yeni xəstə qeydi yaradır admin · katib · həkim

GET /v1/patients/{id} Tək xəstənin təfərrüatını gətirir Bütün yetkili rollar

PUT /v1/patients/{id} Xəstə məlumatlarını yeniləyir admin · katib · həkim

DELETE /v1/patients/{id} Xəstəni arxivləşdirir (soft-delete) admin

GET /v1/patients/{id}/medical Anamnez, allergiya və tibbi keçmişi siyahılayır Bütün yetkili rollar

POST /v1/patients/{id}/medical Tibbi/anamnez qeydi əlavə edir admin · həkim

GET /v1/patients/{id}/documents Xəstə sənədlərini siyahılayır Bütün yetkili rollar

POST /v1/patients/{id}/documents Xəstəyə sənəd əlavə edir admin · katib

Nümunə İstifadə

Yeni xəstə yarat

Sorğu

curl -X POST https://api.udentiva.com/v1/patients \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Idempotency-Key: 9f1c2e7a-..." \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Ayse","last_name":"Yilmaz","phone":"+90555..."}'

Cavab

HTTP/1.1 201 Created
{
  "id": "c0ffee00-1234-...",
  "first_name": "Ayse",
  "last_name": "Yilmaz",
  "phone": "+90555...",
  "created_at": "2026-06-24T09:00:00Z"
}

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:

Veri izolyasiyası: bütün xəstə sorğuları, açarın bağlı olduğu klinika ilə sətir səviyyəsində (RLS) məhdudlaşır; başqa klinikanın xəstəsi heç vaxt qaytarılmır.

Rol əsaslı yetki: yaratma/yeniləmə admin, katib və ya həkim; silmə yalnız admin. Yetki API səviyyəsində məcbur edilir.

Həssas veri (TCKN, sağlıq verisi) maskalanır və audit qeydinə xam yazılmır.

Silmə = soft-delete (deleted_at); qeyd anonimləşdirilir, fiziki olaraq silinmir (KVKK uyumlu).

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

Görüş & Təqvim 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