UDENTIVA แพลตฟอร์มการจัดการทันตกรรมอัจฉริยะ

การส่งออกข้อมูลและสคีมา VIEW

การถ่ายโอนข้อมูล (Export API)

การถ่ายโอนข้อมูลแบบควบคุมและอ่านอย่างเดียว เฉพาะผู้ดำเนินการแพลตฟอร์ม (SuperUser) เท่านั้นที่กำหนดการเชื่อมต่อ + คีย์สำหรับคลินิกหนึ่งได้ คีย์จะดึงข้อมูลของคลินิกนั้นจากชุดข้อมูล "VEM Görüntüsü" (view แบบจำลองข้อมูลขั้นต่ำ) ที่เลือกไว้ ไม่มีการเข้าถึงข้ามผู้เช่า สอดคล้องกับข้อผูกพันด้านการเคลื่อนย้ายข้อมูล (ระเบียบเลขที่ 39682 มาตรา 14)

ทำงานอย่างไร

SuperUser กำหนด

ผู้ดำเนินการแพลตฟอร์ม (ซูเปอร์แอดมิน) สร้างลิงก์สำหรับคลินิกและเลือกว่าจะส่งออกชุดข้อมูลใด (VEM View) คีย์ API แบบใช้ครั้งเดียวจะถูกสร้างขึ้น

การเข้าถึงด้วยคีย์

ระบบภายนอก (เช่น บัญชี รายงาน การส่งออกให้หน่วยงานกำกับ) ดึงข้อมูลแบบอ่านอย่างเดียวด้วยส่วนหัว Authorization: Bearer คีย์จะเห็นเฉพาะข้อมูลของคลินิกนั้นเท่านั้น

ควบคุมได้และตรวจสอบได้

ทุกการดึงข้อมูลถูกบันทึก เมื่อขอ ลิงก์จะถูกปิดใช้งาน/ยกเลิกทันที ข้อมูลคงที่ตามสคีมาของ view การเปลี่ยนแปลงในตารางภายในไม่กระทบภายนอก

การยืนยันตัวตน

ทุกคำขอต้องพกคีย์ส่งออก (export key) รองรับสองวิธี คีย์จะถูกเก็บเป็นแฮช SHA-256 เท่านั้น

Authorization: Bearer udx_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
— หรือ —X-Export-Key: udx_xxxxxxxxxxxxxxxxxxxxxxxxxxxx

เอนด์พอยต์

GET /export/v1 คืนค่าชุดข้อมูลที่คีย์ได้รับอนุญาตและข้อมูลการใช้งาน (การค้นพบ) คีย์สำหรับส่งออก

GET /export/v1/{dataset} ดึงชุดข้อมูลที่เลือกแบบแบ่งหน้า (?limit=1000&offset=0) คีย์สำหรับส่งออก

ตัวอย่างการใช้งาน

ดึงผู้ป่วย (VEM Görüntüsü)

คำขอ

curl https://udentiva.com/export/v1/patients?limit=1000 \
  -H "Authorization: Bearer udx_xxxxxxxx"

การตอบกลับ

HTTP/1.1 200 OK
{
  "dataset": "patients",
  "count": 1000,
  "limit": 1000,
  "offset": 0,
  "rows": [ { "patient_id": "...", "tenant_id": "...", "first_name": "..." } ]
}

VEM View — สคีมา View

ชุดข้อมูลที่ส่งออกได้ทุกชุดคือ VEM View (Minimum Veri Modeli view) ที่มีคอลัมน์คงที่ ด้านล่างจะแสดงสคีมาคอลัมน์ทั้งหมด ชนิดข้อมูล และ (หากมี) ฟิลด์ที่ตรงกันตาม VEM ของกระทรวงสาธารณสุขในแต่ละชุด ฟิลด์จำนวนเงินจะส่งคืนเป็นทศนิยม (numeric) รหัสประจำตัวเป็น uuid และวันที่เป็น ISO-8601 (timestamptz)

Hastalar patients VEM: VEM_HASTA 32 คอลัมน์

Hasta demografik kaydı (silinmiş kayıtlar hariç). Özel nitelikli veri içerir; yalnız yetkili kontrollü aktarım içindir.

คอลัมน์	ชนิด	รายละเอียด
patient_id	uuid	Hasta kimliği (birincil anahtar)
tenant_id	uuid	Klinik kimliği (kayıt bu kliniğe aittir)
national_id	text	TCKN / TC Kimlik Numarası
first_name	text	Ad (AD)
last_name	text	Soyad (SOYADI)
full_name	text	Tam ad (eski tek-alan)
nationality	text	Uyruk (UYRUK)
patient_type	text	Hasta tipi (HASTA_TIPI)
birth_date	date	Doğum tarihi
declared_birth_date	date	Beyan doğum tarihi (BEYAN_DOGUM_TARIHI)
gender	text	Cinsiyet (CINSIYET)
birth_place	text	Doğum yeri (DOGUM_YERI)
mother_tckn	text	Anne TCKN
father_tckn	text	Baba TCKN
mother_name	text	Anne adı
father_name	text	Baba adı
birth_order	smallint	Doğum sırası (DOGUM_SIRASI)
marital_status	text	Medeni hali (MEDENI_HALI)
occupation	text	Meslek (MESLEK)
education_level	text	Öğrenim durumu (OGRENIM_DURUMU)
blood_type	text	Kan grubu (KAN_GRUBU)
disability_status	text[]	Engellilik durumu (ENGELLILIK_DURUMU, dizi)
death_date	date	Ölüm tarihi (OLUM_TARIHI)
death_place	text	Ölüm yeri (OLUM_YERI)
passport_no	text	Pasaport numarası
yupass_no	text	YUPASS numarası
last_institution_code	text	Son kurum kodu
unidentified_info	text	Kimliksiz hasta bilgisi
phone	text	Telefon
email	text	E-posta
created_at	timestamptz	Oluşturulma zamanı
updated_at	timestamptz	Güncellenme zamanı

Başvurular visits VEM: VEM_HASTA_BASVURU 21 คอลัมน์

Hasta başvuru / muayene kaydı (başvuru protokolü, hekim, kabul bilgileri).

คอลัมน์	ชนิด	รายละเอียด
visit_id	uuid	Başvuru kimliği
tenant_id	uuid	Klinik kimliği
branch_id	uuid	Şube kimliği
patient_id	uuid	Hasta kimliği
parent_visit_id	uuid	Bağlı olduğu başvuru
doctor_id	uuid	Hekim kodu (HEKIM_KODU)
assistant_doctor_id	uuid	Asistan hekim kodu
book_no	text	Defter numarası
daily_seq	integer	Günlük sıra numarası
priority	text	Muayene öncelik sırası
institution_code	text	Kurum kodu
online_protocol_no	text	Online protokol numarası
admission_protocol_no	text	Başvuru protokol numarası
admitted_at	timestamptz	Hasta kabul zamanı
admission_type	text	Kabul şekli
social_security_status	text	Sosyal güvence durumu
case_type	text	Vaka türü
referral_diagnosis	text[]	Sevk tanısı (dizi)
doctor_note	text	Hekim başvuru notu
created_at	timestamptz	Oluşturulma
updated_at	timestamptz	Güncellenme

Tanılar diagnoses VEM: VEM_BASVURU_TANI 11 คอลัมน์

Başvuruya bağlı tanılar (ICD-10).

คอลัมน์	ชนิด	รายละเอียด
diagnosis_id	uuid	Tanı kimliği
tenant_id	uuid	Klinik kimliği
patient_id	uuid	Hasta kimliği
visit_id	uuid	Başvuru kimliği
icd10_code	text[]	Tanı kodu (ICD-10, dizi)
diagnosis_type	text	Tanı türü
is_primary	boolean	Birincil tanı mı
diagnosed_at	timestamptz	Tanı zamanı
doctor_id	uuid	Hekim kodu
created_at	timestamptz	Oluşturulma
updated_at	timestamptz	Güncellenme

Reçeteler prescriptions VEM: VEM_RECETE 12 คอลัมน์

Reçete başlığı (MEDULA e-reçete, e-imza durumu).

คอลัมน์	ชนิด	รายละเอียด
prescription_id	uuid	Reçete kimliği
tenant_id	uuid	Klinik kimliği
patient_id	uuid	Hasta kimliği
visit_id	uuid	Başvuru kimliği
doctor_id	uuid	Hekim kimliği
prescription_type	text	Reçete türü
prescription_subtype	text	Reçete alt türü
medula_erecete_no	text	MEDULA e-reçete numarası
esign_status	text	Reçete e-imza durumu
sgk_follow_no	text	SGK takip numarası
created_at	timestamptz	Oluşturulma
updated_at	timestamptz	Güncellenme

Reçete İlaçları prescription_items VEM: VEM_RECETE_ILAC 15 คอลัมน์

Reçetedeki ilaç kalemleri (barkod, doz, kullanım).

คอลัมน์	ชนิด	รายละเอียด
item_id	uuid	Kalem kimliği
tenant_id	uuid	Klinik kimliği
prescription_id	uuid	Reçete kimliği
barcode	text	Barkod
drug_name	text	İlaç adı
box_count	integer	Kutu adedi
dose_unit	text	Doz birimi
usage_form	text	İlaç kullanım şekli
usage_count	integer	İlaç kullanım sayısı
usage_dose	text	İlaç kullanım dozu
usage_period	integer	İlaç kullanım periyodu
period_unit	text	Periyot birimi
note	text	İlaç açıklama
created_at	timestamptz	Oluşturulma
updated_at	timestamptz	Güncellenme

Randevular appointments VEM: RANDEVU 19 คอลัมน์

Randevu kayıtları (MHRS, gelme durumu, iptal).

คอลัมน์	ชนิด	รายละเอียด
appointment_id	uuid	Randevu kimliği
tenant_id	uuid	Klinik kimliği
branch_id	uuid	Şube kimliği
patient_id	uuid	Hasta kimliği
doctor_id	uuid	Hekim kimliği
unit_id	uuid	Ünite/koltuk kimliği
visit_id	uuid	Başvuru kimliği
start_at	timestamptz	Başlangıç
end_at	timestamptz	Bitiş
status	text	Durum
priority	text	Öncelik
appointment_type	text	Randevu türü
appointment_subtype	text	Randevu alt türü
mhrs_hrn	text	MHRS HRN kodu
attendance_status	text	Randevu gelme durumu
cancelled_at	timestamptz	İptal zamanı
cancel_reason	text	İptal nedeni
created_at	timestamptz	Oluşturulma
updated_at	timestamptz	Güncellenme

Hizmet Kataloğu services VEM: HIZMET 6 คอลัมน์

Klinik hizmet/işlem kataloğu ve fiyatları.

คอลัมน์	ชนิด	รายละเอียด
service_id	uuid	Hizmet kimliği
tenant_id	uuid	Klinik kimliği
code	text	Hizmet kodu
name	text	Hizmet adı
price	numeric	Birim fiyat (para; ondalık)
updated_at	timestamptz	Güncellenme

Tedavi Kalemleri treatment_items VEM: HASTA_HIZMET 14 คอลัมน์

Tedavi planı kalemleri (uygulanan/planlanan işlemler, fatura durumu).

คอลัมน์	ชนิด	รายละเอียด
item_id	uuid	Kalem kimliği
tenant_id	uuid	Klinik kimliği
plan_id	uuid	Tedavi planı kimliği
service_id	uuid	Hizmet kimliği
visit_id	uuid	Başvuru kimliği
tooth_no	text	Diş numarası (FDI)
surface	text	Yüzey
price	numeric	Fiyat (para)
status	text	Plan durumu
service_status	text	Hasta hizmet durumu
billing_status	text	Hizmet fatura durumu
side_info	text	Taraf bilgisi
performed_at	timestamptz	İşlem zamanı
updated_at	timestamptz	Güncellenme

Diş Durumları tooth_states VEM: DIS_ISLEM 13 คอลัมน์

Odontogram diş durumları (FDI, append-only).

คอลัมน์	ชนิด	รายละเอียด
tooth_state_id	uuid	Diş durumu kimliği
tenant_id	uuid	Klinik kimliği
patient_id	uuid	Hasta kimliği
visit_id	uuid	Başvuru kimliği
tooth_no	integer	Diş numarası (FDI)
surface	text	Yüzey
condition	text	Durum/işlem
dental_action_type	text	Diş işlem türü
medula_tooth_code	text	Diş kodu (MEDULA)
result_code	text	Sonuç kodu
result_message	text	Sonuç mesajı
recorded_at	timestamptz	Kayıt zamanı
updated_at	timestamptz	Güncellenme

Faturalar invoices VEM: FATURA 14 คอลัมน์

Fatura başlıkları (MEDULA teslim, bütçe kodu, dönem).

คอลัมน์	ชนิด	รายละเอียด
invoice_id	uuid	Fatura kimliği
tenant_id	uuid	Klinik kimliği
patient_id	uuid	Hasta kimliği
visit_id	uuid	Başvuru kimliği
total	numeric	Toplam tutar (para)
status	text	Durum
invoice_type	text	Fatura türü
invoice_no	text	Fatura numarası
period	text	Fatura dönemi
medula_delivery_no	text	MEDULA teslim numarası
budget_code	text	Bütçe kodu
einvoice_status	text	e-Fatura durumu
created_at	timestamptz	Oluşturulma
updated_at	timestamptz	Güncellenme

Fatura Kalemleri invoice_lines VEM: FATURA_KALEM 8 คอลัมน์

Fatura satırları (açıklama, miktar, tutar).

คอลัมน์	ชนิด	รายละเอียด
line_id	uuid	Satır kimliği
tenant_id	uuid	Klinik kimliği
invoice_id	uuid	Fatura kimliği
description	text	Açıklama
qty	numeric	Miktar
unit_price	numeric	Birim fiyat (para)
line_total	numeric	Satır toplamı (para)
updated_at	timestamptz	Güncellenme

Tahsilatlar payments VEM: TAHSILAT 8 คอลัมน์

Ödeme/tahsilat kayıtları.

คอลัมน์	ชนิด	รายละเอียด
payment_id	uuid	Tahsilat kimliği
tenant_id	uuid	Klinik kimliği
patient_id	uuid	Hasta kimliği
invoice_id	uuid	Fatura kimliği
amount	numeric	Tutar (para)
method	text	Ödeme yöntemi
paid_at	timestamptz	Tahsilat zamanı
updated_at	timestamptz	Güncellenme

โมเดลความปลอดภัย

กำหนดโดย SuperUser: การเชื่อมต่อถูกสร้างขึ้นเฉพาะในระนาบควบคุมของแพลตฟอร์มเท่านั้น ปลายทางเหล่านี้ไม่สามารถค้นพบได้ใน public API และคลินิกไม่สามารถสร้างคีย์เองได้

ล็อกกับผู้เช่า + fail-closed: แต่ละคีย์ผูกกับคลินิกเดียวเท่านั้น export view ทำงานด้วย security_invoker + ตัวกรองผู้เช่าที่ฝังไว้ — หากไม่มีบริบท จะไม่มีแถวใดถูกส่งกลับเลย

อ่านอย่างเดียว: เฉพาะ GET คีย์ถูกจัดเก็บเป็น SHA-256 hash เท่านั้น คีย์แบบข้อความล้วนจะแสดงเพียงครั้งเดียวตอนสร้าง การปิดใช้งาน/ยกเลิกมีผลทันที

ตรวจสอบได้: ทุกการดึงข้อมูล (การเชื่อมต่อ, ชุดข้อมูล, จำนวนแถว, IP) จะถูกบันทึกลงในบันทึกการเข้าถึง

โมเดลความปลอดภัยทั้งหมด →

แหล่งข้อมูลอื่น ๆ

ผู้ป่วย การนัดหมาย & ปฏิทิน Odontogram & การรักษา การเก็บเงินและการเงิน สต็อก การถ่ายภาพ ห้องปฏิบัติการ Lead & CRM การท่องเที่ยวเชิงสุขภาพ การรายงาน & BI Webhooks

ต้องการตั้งค่าการส่งออกข้อมูลหรือไม่

ลิงก์ส่งออกจะถูกกำหนดโดยผู้ดำเนินการแพลตฟอร์ม ด้วยการอนุมัติของคลินิกคุณ

ติดต่อเรา