UDENTIVA Aqlli dental boshqaruv platformasi
DASTURCHILAR

UDENTIVA API Hujjatlari

Klinika ma’lumotingizni o‘z tizimlaringiz bilan xavfsiz tarzda integratsiyalang. REST asosidagi, izchil va bashoratli API.

Tashqi API kirishi tez orada ochiladi
Quyidagi so‘nggi nuqtalar tashqariga ochiladigan to‘liq qamrovdir. Erta kirish uchun biz bilan bog‘laning.
API Xavfsizlik Modeli
Ma’lumot izolyatsiyasi, idempotent yozuv, parametrli so‘rov — kodga asoslangan xavfsizlik. →

Umumiy Ko‘rinish

UDENTIVA API REST tamoyillariga rioya qiladi; JSON tanasidan foydalanadi va standart HTTP holat kodlarini qaytaradi. Barcha so‘rovlar HTTPS orqali amalga oshiriladi va API kaliti bilan tasdiqlanadi. Har bir so‘rov kalit bog‘langan klinika ma’lumoti bilan cheklangan (to‘liq ma’lumot izolyatsiyasi).

Asosiy manzil:

https://api.udentiva.com

Kirishni Tasdiqlash

So‘rovlarda API kalitingizni Authorization sarlavhasida olib yuring. Kalitlar klinika paneli orqali yaratiladi va istagan paytda bekor qilinishi mumkin.

# Namuna so‘rov
curl https://api.udentiva.com/v1/patients \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Accept: application/json"

So‘nggi nuqtalar

81 uch · 12 manba

Tashqariga ochiladigan barcha so‘nggi nuqtalar quyida. Har bir resursning tafsilot sahifasida parametrlar, namuna so‘rov/javob va xavfsizlik izohlari mavjud. Yozuv uchlari Idempotency-Key sarlavhasini qo‘llab-quvvatlaydi.

Bemorlar · 9

Tafsilot va misol →
GET /v1/patients Bemorlar roʻyxatini sahifalab oladi
POST /v1/patients Yangi bemor yozuvini yaratadi
GET /v1/patients/{id} Bitta bemorning tafsilotini oladi
PUT /v1/patients/{id} Bemor maʼlumotlarini yangilaydi
DELETE /v1/patients/{id} Bemorni arxivlaydi (soft-delete)
GET /v1/patients/{id}/medical Anamnez, allergiya va tibbiy tarixni roʻyxatlaydi
POST /v1/patients/{id}/medical Tibbiy/anamnez yozuvi qoʻshadi
GET /v1/patients/{id}/documents Bemor hujjatlarini roʻyxatlaydi
POST /v1/patients/{id}/documents Bemorga hujjat qoʻshadi

Uchrashuv va taqvim · 10

Tafsilot va misol →
GET /v1/appointments Qabullarni sana oraligʻi boʻyicha roʻyxatlaydi
POST /v1/appointments Yangi qabul yaratadi (toʻqnashuv nazorati bilan)
POST /v1/appointments/{id}/status Qabul (randevu) holatini oʻzgartiradi
POST /v1/appointments/{id}/reschedule Qabulni qayta rejalashtiradi
POST /v1/appointments/{id}/remind Qabul eslatmasini yuboradi
GET /v1/units Kreslo/qurilmalarni roʻyxatlaydi
GET /v1/doctors Shifokorlarni roʻyxatlaydi
GET /v1/waitlist Kutish roʻyxatini oladi
POST /v1/waitlist Kutish roʻyxatiga bemor qoʻshadi
DELETE /v1/waitlist/{id} Kutish roʻyxatidan chiqaradi

Odontogramma & Davolash · 14

Tafsilot va misol →
GET /v1/patients/{id}/odontogram Joriy FDI tish xaritasini oladi
POST /v1/patients/{id}/odontogram Tish holatini qoʻshadi (append-only)
GET /v1/patients/{id}/odontogram/{tooth}/history Bir tishning holat tarixini oladi
GET /v1/services Xizmat/muolaja katalogini roʻyxatlaydi
POST /v1/services Xizmat elementini qoʻshadi
PUT /v1/services/{id} Xizmat elementini yangilaydi
GET /v1/patients/{id}/plans Bemorning davolash rejalarini roʻyxatlaydi
POST /v1/patients/{id}/plans Davolash rejasini yaratadi
GET /v1/plans/{id} Davolash rejasi tafsilotini oladi
POST /v1/plans/{id}/status Reja holatini oʻzgartiradi
POST /v1/plans/{id}/items Rejaga bosqich/element qoʻshadi
POST /v1/plan-items/{id}/status Reja elementining holatini oʻzgartiradi
GET /v1/patients/{id}/prescriptions Retseptlarni roʻyxatlaydi
POST /v1/patients/{id}/prescriptions Retsept yaratadi

Undirish va Moliya · 12

Tafsilot va misol →
POST /v1/invoices Hisob-faktura yaratadi
GET /v1/invoices Hisob-fakturalarni roʻyxatlaydi
GET /v1/invoices/{id} Hisob-faktura tafsilotini oladi
POST /v1/invoices/{id}/void Hisob-fakturani bekor qiladi (teskari yozuv)
POST /v1/invoices/{id}/einvoice Hisob-fakturani e-Fatura sifatida yuboradi (GİB)
GET /v1/einvoices e-Fatura yozuvlarini roʻyxatlaydi
POST /v1/payments Toʻlovni qayd etadi (idempotent)
GET /v1/patients/{id}/balance Bemorning joriy balansini oladi
GET /v1/patients/{id}/ledger Bemorning joriy hisob harakatlarini roʻyxatlaydi
GET /v1/cash/day Kun oxiri kassa xulosasini oladi
GET /v1/cari Joriy (cari) balanslarni roʻyxatlaydi
GET /v1/billing/summary Moliya/toʻlov xulosasini oladi

Zaxira · 6

Tafsilot va misol →
GET /v1/stock Zaxira kartalarini roʻyxatlaydi
GET /v1/stock/critical Kritik darajadagi zaxiralarni roʻyxatlaydi
POST /v1/stock Zaxira kartasini yaratadi
PUT /v1/stock/{id} Zaxira kartasini yangilaydi
POST /v1/stock/{id}/movement Zaxira harakati (kirim/chiqim) qoʻshadi
GET /v1/stock/{id}/movements Zaxira harakatlarini roʻyxatlaydi

Tasvirlash · 3

Tafsilot va misol →
GET /v1/patients/{id}/images Bemor tasvirlarini (rentgen/foto) roʻyxatlaydi
POST /v1/patients/{id}/images Tasvir yuklaydi (S3, stream/presigned)
GET /v1/images/{id}/raw Tasvir faylini yuklab oladi (presigned)

Laboratoriya · 7

Tafsilot va misol →
GET /v1/lab-orders Lab buyurtmalarini roʻyxatlaydi
POST /v1/lab-orders Lab buyurtmasini yaratadi
GET /v1/lab-orders/{id} Buyurtma tafsilotini oladi
PUT /v1/lab-orders/{id} Buyurtmani yangilaydi
POST /v1/lab-orders/{id}/status Buyurtma holatini oʻzgartiradi
GET /v1/labs Shartnomaviy laboratoriyalarni roʻyxatlaydi
POST /v1/labs Laboratoriya qoʻshadi

Lead & CRM · 7

Tafsilot va misol →
GET /v1/leads Lead/soʻrovlarni roʻyxatlaydi
POST /v1/leads Yangi lead yaratadi
POST /v1/leads/{id}/status Lead holatini/bosqichini oʻzgartiradi
GET /v1/tasks Vazifalarni roʻyxatlaydi
POST /v1/tasks Vazifa yaratadi
GET /v1/messages Bemor bilan aloqa xabarlarini roʻyxatlaydi
POST /v1/messages Xabar/aloqa yozuvi yaratadi

Sogʻliq turizmi · 5

Tafsilot va misol →
GET /v1/tourism-cases Sogʻliq turizmi holatlarini roʻyxatlaydi
POST /v1/tourism-cases Turizm holatini yaratadi
POST /v1/tourism-cases/{id}/status Holat bosqichini oʻzgartiradi
GET /v1/shipments Transfer/joʻnatma yozuvlarini roʻyxatlaydi
POST /v1/shipments Transfer/joʻnatma yozuvi yaratadi

Hisobot & BI · 3

Tafsilot va misol →
GET /v1/bi Biznes-tahlil (BI) koʻrsatkichlarini oladi
GET /v1/profit Rentabellik hisobotini oladi
GET /v1/rcm Daromad tsikli (RCM) koʻrsatkichlarini oladi

Webhooks · 3

Tafsilot va misol →
GET /v1/webhooks Roʻyxatga olingan webhook obunalarini roʻyxatlaydi
POST /v1/webhooks Hodisa bildirishnomasi uchun webhook roʻyxatga oladi
DELETE /v1/webhooks/{id} Webhook obunasini oʻchiradi

Maʼlumot Uzatish (Export API) · 2

Tafsilot va misol →
GET /export/v1 Kalitning ruxsat etilgan maʼlumot toʻplamlari va foydalanish maʼlumotini qaytaradi (kashfiyot)
GET /export/v1/{dataset} Tanlangan maʼlumot toʻplamini sahifalab tortib oladi (?limit=1000&offset=0)

Xato Formati

Xatolar izchil qobiq bilan qaytadi; kod mashinaga, xabar foydalanuvchiga qaratilgan. Ichki xato/stack hech qachon sizib chiqmaydi.

{
  "error": {
    "code": "validation_failed",
    "message": "Yaroqsiz maydon: e-pochta"
  }
}

Tezlik Chegarasi

So‘rovlar daqiqasiga cheklanadi. Chegara oshirilganda 429 qaytadi; javob sarlavhalarida qolgan kvota ma’lumoti uzatiladi.

Versiyalash

API versiyasi yo‘lda uzatiladi (masalan /v1). Orqaga moslikni buzuvchi o‘zgarishlar yangi versiya bilan chiqariladi.

Webhook Hodisalari

Klinikangizda hodisalar yuz berishi bilan qayd etilgan manzilingizga imzolangan xabarnoma yuboriladi. Shu tariqa o‘z tizimingizni onlayn dolzarb tutasiz.

# Namuna hodisa turlari
patient.created   appointment.created   appointment.status_changed
invoice.created   payment.created       lab_order.status_changed
treatment_plan.updated   lead.created   tourism_case.status_changed
Erta kirishni istaysizmi?
API ochilganda birinchi bo‘lib siz xabardor bo‘ling.
Bogʻlanish