API MƏNBƏSİ

Odontoqram & Müalicə

FDI diş xəritəsi, xidmət/əməliyyat kataloqu, mərhələli müalicə planı və resept. Diş vəziyyətləri append-only saxlanılır — keçmiş silinmir, üzərinə yazılmır.

Erkən Giriş Bütün API

Uçlar

14 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/{id}/odontogram Cari FDI diş xəritəsini gətirir Bütün yetkili rollar

POST /v1/patients/{id}/odontogram Diş vəziyyəti əlavə edir (append-only) admin · həkim

GET /v1/patients/{id}/odontogram/{tooth}/history Bir dişin vəziyyət tarixçəsini gətirir Bütün yetkili rollar

GET /v1/services Xidmət/əməliyyat kataloqunu siyahılayır Bütün yetkili rollar

POST /v1/services Xidmət maddəsi əlavə edir admin

PUT /v1/services/{id} Xidmət maddəsini yeniləyir admin

GET /v1/patients/{id}/plans Xəstənin müalicə planlarını siyahılayır Bütün yetkili rollar

POST /v1/patients/{id}/plans Müalicə planı yaradır admin · həkim

GET /v1/plans/{id} Müalicə planı təfərrüatını gətirir Bütün yetkili rollar

POST /v1/plans/{id}/status Plan vəziyyətini dəyişir admin · həkim

POST /v1/plans/{id}/items Plana mərhələ/maddə əlavə edir admin · həkim

POST /v1/plan-items/{id}/status Plan maddəsinin vəziyyətini dəyişir admin · həkim

GET /v1/patients/{id}/prescriptions Reseptləri siyahılayır Bütün yetkili rollar

POST /v1/patients/{id}/prescriptions Resept yaradır admin · həkim

Nümunə İstifadə

Diş vəziyyəti əlavə et (append-only)

Sorğu

curl -X POST https://api.udentiva.com/v1/patients/{id}/odontogram \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"tooth":"11","state":"caries","surface":"mesial"}'

Cavab

HTTP/1.1 201 Created
{
  "id": "st-77",
  "tooth": "11",
  "state": "caries",
  "recorded_at": "2026-06-24T09:10: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:

Diş vəziyyəti qeydləri append-only-dır: hər dəyişiklik yeni sətir olaraq əlavə olunur, köhnə qeyd dəyişdirilə bilməz (klinik keçmişin bütövlüyü).

Müalicə planı və resept yaratma yalnız admin/həkim roluna açıqdır; qiymət və mərhələ məntiqi serverdə işlədilir.

Bütün qeydlər klinikanıza izolyasiya olunub; plan-qiymət hesabları müştəridən alınmır, serverdə numeric ilə edilir.

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