แหล่งข้อมูล API

ผู้ป่วย

แฟ้มผู้ป่วย: ข้อมูลประชากร ประวัติการเจ็บป่วย/ภูมิแพ้ ประวัติทางการแพทย์ และเอกสาร ทุกบันทึกถูกแยกให้เฉพาะคลินิกของคุณ การลบเป็นการจัดเก็บถาวรที่ย้อนกลับได้ (ไม่มี hard-delete)

สิทธิ์เข้าถึงก่อนใคร (Early Access) API ทั้งหมด

เอนด์พอยต์

9 เอนด์พอยต์

เอนด์พอยต์ของแหล่งข้อมูลนี้ แต่ละเอนด์พอยต์จำกัดอยู่เฉพาะข้อมูลคลินิกที่ผูกกับคีย์ API เท่านั้น เอนด์พอยต์สำหรับเขียนรองรับส่วนหัว Idempotency-Key

GET /v1/patients ดึงรายการผู้ป่วยแบบแบ่งหน้า ทุกบทบาทที่ได้รับอนุญาต

POST /v1/patients สร้างบันทึกผู้ป่วยใหม่ admin · เลขานุการ · แพทย์

GET /v1/patients/{id} ดึงรายละเอียดของผู้ป่วยรายเดียว ทุกบทบาทที่ได้รับอนุญาต

PUT /v1/patients/{id} อัปเดตข้อมูลผู้ป่วย admin · เลขานุการ · แพทย์

DELETE /v1/patients/{id} จัดเก็บผู้ป่วยเข้าคลัง (soft-delete) admin

GET /v1/patients/{id}/medical แสดงรายการประวัติการเจ็บป่วย ภูมิแพ้ และประวัติทางการแพทย์ ทุกบทบาทที่ได้รับอนุญาต

POST /v1/patients/{id}/medical เพิ่มบันทึกทางการแพทย์/ประวัติการเจ็บป่วย admin · แพทย์

GET /v1/patients/{id}/documents แสดงรายการเอกสารของผู้ป่วย ทุกบทบาทที่ได้รับอนุญาต

POST /v1/patients/{id}/documents เพิ่มเอกสารให้ผู้ป่วย admin · เลขานุการ

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

สร้างผู้ป่วยใหม่

คำขอ

curl -X POST https://api.udentiva.com/v1/patients \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Idempotency-Key: 9f1c2e7a-..." \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Ayse","last_name":"Yilmaz","phone":"+90555..."}'

การตอบกลับ

HTTP/1.1 201 Created
{
  "id": "c0ffee00-1234-...",
  "first_name": "Ayse",
  "last_name": "Yilmaz",
  "phone": "+90555...",
  "created_at": "2026-06-24T09:00:00Z"
}

ความปลอดภัยของแหล่งข้อมูลนี้

ความปลอดภัยไม่ใช่ฟีเจอร์ แต่คือสถาปัตยกรรมเอง การรับประกันที่มีผลกับแหล่งข้อมูลนี้:

การแยกข้อมูล: การค้นหาผู้ป่วยทั้งหมดถูกจำกัดในระดับแถว (RLS) ไว้ที่คลินิกที่คีย์ผูกอยู่ ผู้ป่วยของคลินิกอื่นจะไม่ถูกคืนค่าเด็ดขาด

สิทธิ์ตามบทบาท: การสร้าง/อัปเดตทำได้โดย admin, เลขานุการ หรือแพทย์ การลบทำได้เฉพาะ admin เท่านั้น สิทธิ์ถูกบังคับใช้ในชั้น API

ข้อมูลอ่อนไหว (TCKN, ข้อมูลสุขภาพ) ถูกปิดบัง และจะไม่ถูกเขียนแบบดิบลงในบันทึกการตรวจสอบ

การลบ = soft-delete (deleted_at) บันทึกถูกทำให้ไม่ระบุตัวตน ไม่ได้ถูกลบจริง (สอดคล้องกับ KVKK)

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

รูปแบบข้อผิดพลาด

ข้อผิดพลาดจะส่งคืนในรูปแบบซองที่สอดคล้องกัน โค้ดสำหรับเครื่อง ข้อความสำหรับผู้ใช้ ข้อผิดพลาดภายใน/stack จะไม่มีวันรั่วไหลออกไป

{
  "error": {
    "code": "validation_failed",
    "message": "ฟิลด์ไม่ถูกต้อง: อีเมล"
  }
}

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

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

ต้องการสิทธิ์เข้าถึงก่อนใครหรือไม่

เป็นคนแรกที่รู้เมื่อ API เปิดให้ใช้งาน

ติดต่อเรา