API RESURSI

Undirish va Moliya

Hisob-faktura, idempotent toʻlov, joriy balans, kun oxiri hisob-kitobi va e-Fatura. Pul numeric(14,2) bilan saqlanadi; joriy balans hosil qilinadi, qoʻlda yozilmaydi.

Erta Kirish Barcha API

So‘nggi nuqtalar

12 uch

Bu resursga tegishli so‘nggi nuqtalar. Har bir uch API kaliti bog‘langan klinika ma’lumoti bilan cheklangan; yozuv uchlari Idempotency-Key sarlavhasini qo‘llab-quvvatlaydi.

POST /v1/invoices Hisob-faktura yaratadi admin · kotib · shifokor

GET /v1/invoices Hisob-fakturalarni roʻyxatlaydi admin

GET /v1/invoices/{id} Hisob-faktura tafsilotini oladi Barcha vakolatli rollar

POST /v1/invoices/{id}/void Hisob-fakturani bekor qiladi (teskari yozuv) admin

POST /v1/invoices/{id}/einvoice Hisob-fakturani e-Fatura sifatida yuboradi (GİB) admin

GET /v1/einvoices e-Fatura yozuvlarini roʻyxatlaydi admin

POST /v1/payments Toʻlovni qayd etadi (idempotent) admin · kotib · shifokor

GET /v1/patients/{id}/balance Bemorning joriy balansini oladi Barcha vakolatli rollar

GET /v1/patients/{id}/ledger Bemorning joriy hisob harakatlarini roʻyxatlaydi Barcha vakolatli rollar

GET /v1/cash/day Kun oxiri kassa xulosasini oladi admin · kotib

GET /v1/cari Joriy (cari) balanslarni roʻyxatlaydi admin · kotib

GET /v1/billing/summary Moliya/toʻlov xulosasini oladi admin · kotib

Namuna Foydalanish

Toʻlovni qayd etish (idempotent)

So‘rov

curl -X POST https://api.udentiva.com/v1/payments \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Idempotency-Key: pay-7c3f..." \
  -H "Content-Type: application/json" \
  -d '{"patient_id":"c0ffee00-...","amount":"1500.00","method":"card"}'

Javob

HTTP/1.1 201 Created
{
  "id": "pmt-9001",
  "amount": "1500.00",
  "method": "card",
  "created_at": "2026-06-24T09:15:00Z"
}

# Aynı Idempotency-Key ile tekrar → aynı kayıt döner, ikinci tahsilat OLUŞMAZ.

Bu resursda xavfsizlik

Xavfsizlik xususiyat emas, arxitekturaning o‘zi. Bu resursda amal qiladigan kafolatlar:

Idempotent toʻlov: Idempotency-Key + server qulfi tufayli tarmoq takroridan ham bir toʻlov ikki marta qayd etilmaydi (ikki marta toʻlov yoʻq).

Pul har doim numeric(14,2); mijozdan kelgan summa bilan arifmetika bajarilmaydi, yaxlitlash yagona nuqtada serverda.

Bekor qilish/qaytarish = teskari yozuv (void/refund); satr jismonan oʻchirilmaydi. Joriy balans Σhisob-faktura − Σtoʻlov sifatida hosil qilinadi.

Koʻp-obyektli amal (hisob-faktura + element + toʻlov) yagona transaction da atomikdir: yo hammasi yo hech biri.

Butun xavfsizlik modeli →

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

Boshqa Resurslar

Bemorlar Uchrashuv va taqvim Odontogramma & Davolash Zaxira Tasvirlash Laboratoriya Lead & CRM Sogʻliq turizmi Hisobot & BI Webhooks Maʼlumot Uzatish (Export API)

Erta kirishni istaysizmi?

API ochilganda birinchi bo‘lib siz xabardor bo‘ling.

Bogʻlanish