Klinika verinizi öz sistemlərinizlə təhlükəsiz şəkildə inteqrasiya edin. REST əsaslı, ardıcıl və proqnozlaşdırıla bilən bir API.
UDENTIVA API, REST prinsiplərinə uyğun gəlir; JSON gövdə istifadə edir və standart HTTP status kodları qaytarır. Bütün sorğular HTTPS üzərindən edilir və API açarı ilə kimlik doğrulanır. Hər sorğu, açarın bağlı olduğu klinikanın verisi ilə məhduddur (tam verilən izolyasiyası).
Əsas ünvan:
https://api.udentiva.com
Sorğularda API açarınızı Authorization başlığında daşıyın. Açarlar klinika paneli üzərindən yaradılır və istədiyiniz zaman ləğv edilə bilər.
# Nümunə sorğu curl https://api.udentiva.com/v1/patients \ -H "Authorization: Bearer udk_live_xxx" \ -H "Accept: application/json"
Kənara açılacaq bütün uc nöqtələr aşağıdadır. Hər mənbənin detal səhifəsində parametrlər, nümunə sorğu/cavab və təhlükəsizlik qeydləri var. Yazma ucları Idempotency-Key başlığını dəstəkləyir.
/v1/patients
Xəstə siyahısını səhifələnmiş gətirir
/v1/patients
Yeni xəstə qeydi yaradır
/v1/patients/{id}
Tək xəstənin təfərrüatını gətirir
/v1/patients/{id}
Xəstə məlumatlarını yeniləyir
/v1/patients/{id}
Xəstəni arxivləşdirir (soft-delete)
/v1/patients/{id}/medical
Anamnez, allergiya və tibbi keçmişi siyahılayır
/v1/patients/{id}/medical
Tibbi/anamnez qeydi əlavə edir
/v1/patients/{id}/documents
Xəstə sənədlərini siyahılayır
/v1/patients/{id}/documents
Xəstəyə sənəd əlavə edir
/v1/appointments
Randevuları tarix aralığına görə siyahılayır
/v1/appointments
Yeni randevu yaradır (toqquşma nəzarətli)
/v1/appointments/{id}/status
Randevu vəziyyətini dəyişir
/v1/appointments/{id}/reschedule
Randevunu yenidən planlaşdırır
/v1/appointments/{id}/remind
Randevu xatırlatması göndərir
/v1/units
Koltuq/vahidləri (kreslo/unit) siyahılayır
/v1/doctors
Həkimləri siyahılayır
/v1/waitlist
Gözləmə siyahısını gətirir
/v1/waitlist
Gözləmə siyahısına xəstə əlavə edir
/v1/waitlist/{id}
Gözləmə siyahısından çıxarır
/v1/patients/{id}/odontogram
Cari FDI diş xəritəsini gətirir
/v1/patients/{id}/odontogram
Diş vəziyyəti əlavə edir (append-only)
/v1/patients/{id}/odontogram/{tooth}/history
Bir dişin vəziyyət tarixçəsini gətirir
/v1/services
Xidmət/əməliyyat kataloqunu siyahılayır
/v1/services
Xidmət maddəsi əlavə edir
/v1/services/{id}
Xidmət maddəsini yeniləyir
/v1/patients/{id}/plans
Xəstənin müalicə planlarını siyahılayır
/v1/patients/{id}/plans
Müalicə planı yaradır
/v1/plans/{id}
Müalicə planı təfərrüatını gətirir
/v1/plans/{id}/status
Plan vəziyyətini dəyişir
/v1/plans/{id}/items
Plana mərhələ/maddə əlavə edir
/v1/plan-items/{id}/status
Plan maddəsinin vəziyyətini dəyişir
/v1/patients/{id}/prescriptions
Reseptləri siyahılayır
/v1/patients/{id}/prescriptions
Resept yaradır
/v1/invoices
Faktura yaradır
/v1/invoices
Fakturaları siyahılayır
/v1/invoices/{id}
Faktura təfərrüatını gətirir
/v1/invoices/{id}/void
Fakturanı ləğv edir (əks qeyd)
/v1/invoices/{id}/einvoice
Fakturanı e-Fatura olaraq göndərir (GİB)
/v1/einvoices
e-Fatura qeydlərini siyahılayır
/v1/payments
Ödəniş qəbulu qeyd edir (idempotent)
/v1/patients/{id}/balance
Xəstə cari balansını gətirir
/v1/patients/{id}/ledger
Xəstə cari hərəkətlərini siyahılayır
/v1/cash/day
Gün sonu kassa xülasəsini gətirir
/v1/cari
Cari balansları siyahılayır
/v1/billing/summary
Maliyyə/ödəniş qəbulu xülasəsini gətirir
/v1/stock
Stok kartlarını siyahılayır
/v1/stock/critical
Kritik səviyyədəki stokları siyahılayır
/v1/stock
Stok kartı yaradır
/v1/stock/{id}
Stok kartını yeniləyir
/v1/stock/{id}/movement
Stok hərəkəti (giriş/çıxış) əlavə edir
/v1/stock/{id}/movements
Stok hərəkətlərini siyahılayır
/v1/patients/{id}/images
Xəstə görüntülərini (rentgen/foto) siyahılayır
/v1/patients/{id}/images
Görüntü yükləyir (S3, stream/presigned)
/v1/images/{id}/raw
Görüntü faylını yükləyir (presigned)
/v1/lab-orders
Lab sifarişlərini siyahılayır
/v1/lab-orders
Lab sifarişi yaradır
/v1/lab-orders/{id}
Sifariş təfərrüatını gətirir
/v1/lab-orders/{id}
Sifarişi yeniləyir
/v1/lab-orders/{id}/status
Sifariş vəziyyətini dəyişir
/v1/labs
Müqaviləli laboratoriyaları siyahılayır
/v1/labs
Laboratoriya əlavə edir
/v1/leads
Lead/müraciətləri siyahılayır
/v1/leads
Yeni lead yaradır
/v1/leads/{id}/status
Lead vəziyyətini/mərhələsini dəyişir
/v1/tasks
Tapşırıqları siyahılayır
/v1/tasks
Tapşırıq yaradır
/v1/messages
Xəstə ünsiyyət mesajlarını siyahılayır
/v1/messages
Mesaj/ünsiyyət qeydi yaradır
/v1/tourism-cases
Sağlıq turizmi hallarını siyahılayır
/v1/tourism-cases
Turizm halı yaradır
/v1/tourism-cases/{id}/status
Hal mərhələsini dəyişir
/v1/shipments
Transfer/göndərmə qeydlərini siyahılayır
/v1/shipments
Transfer/göndərmə qeydi yaradır
/v1/bi
Biznes zəkası (BI) metrikalarını gətirir
/v1/profit
Gəlirlilik hesabatını gətirir
/v1/rcm
Gəlir dövrü (RCM) metrikalarını gətirir
/v1/webhooks
Qeydli webhook abunəliklərini siyahılayır
/v1/webhooks
Hadisə bildirişi üçün webhook qeyd edir
/v1/webhooks/{id}
Webhook abunəliyini silir
/export/v1
Açarın icazə verilmiş verilənlər toplularını və istifadə məlumatını qaytarır (kəşf)
/export/v1/{dataset}
Seçili verilənlər toplusunu səhifələnmiş çəkir (?limit=1000&offset=0)
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"
}
}
Sorğular dəqiqə başına məhdudlaşdırılır. Limit aşıldıqda 429 qayıdır; cavab başlıqlarında qalan kvota məlumatı daşınır.
API versiyası yol üzərində daşınır (məs. /v1). Geriyə uyğunluğu pozan dəyişikliklər yeni bir versiya ilə buraxılır.
Klinikanızda hadisələr baş verdikcə qeydli ünvanınıza imzalı bir bildiriş göndərilir. Beləliklə öz sisteminizi anlıq aktual saxlayırsınız.
# Nümunə hadisə tipləri
patient.created appointment.created appointment.status_changed
invoice.created payment.created lab_order.status_changed
treatment_plan.updated lead.created tourism_case.status_changed
We use cookies necessary for core functionality; analytics and marketing cookies are enabled only with your consent. Kuki Siyasəti