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

การนัดหมาย & ปฏิทิน

การจัดตารางตามแพทย์และยูนิต การป้องกันการจองซ้ำ การแจ้งเตือนอัตโนมัติ และรายการรอ การชนกันของนัดหมายถูกป้องกันในระดับฐานข้อมูล

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

เอนด์พอยต์

10 เอนด์พอยต์

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

GET /v1/appointments แสดงรายการนัดหมายตามช่วงวันที่ ทุกบทบาทที่ได้รับอนุญาต

POST /v1/appointments สร้างนัดหมายใหม่ (ตรวจสอบการชนกัน) admin · เลขานุการ · แพทย์

POST /v1/appointments/{id}/status เปลี่ยนสถานะนัดหมาย admin · เลขานุการ · แพทย์

POST /v1/appointments/{id}/reschedule จัดตารางนัดหมายใหม่ admin · เลขานุการ · แพทย์

POST /v1/appointments/{id}/remind ส่งการแจ้งเตือนนัดหมาย admin · เลขานุการ · แพทย์

GET /v1/units แสดงรายการยูนิต/เก้าอี้ทำฟัน ทุกบทบาทที่ได้รับอนุญาต

GET /v1/doctors แสดงรายการแพทย์ ทุกบทบาทที่ได้รับอนุญาต

GET /v1/waitlist ดึงรายการรอ ทุกบทบาทที่ได้รับอนุญาต

POST /v1/waitlist เพิ่มผู้ป่วยเข้าสู่รายการรอ admin · เลขานุการ · แพทย์

DELETE /v1/waitlist/{id} นำผู้ป่วยออกจากรายการรอ admin · เลขานุการ · แพทย์

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

ดึงนัดหมายตามช่วงวันที่

คำขอ

curl https://api.udentiva.com/v1/appointments?from=2026-06-24&to=2026-06-25 \
  -H "Authorization: Bearer udk_live_xxx"

การตอบกลับ

HTTP/1.1 200 OK
[
  {
    "id": "a1b2...",
    "patient_id": "c0ffee00-...",
    "unit_id": "u-1",
    "starts_at": "2026-06-24T10:00:00Z",
    "ends_at": "2026-06-24T10:30:00Z",
    "status": "confirmed"
  }
]

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

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

การจองซ้ำเป็นไปไม่ได้ในระดับฐานข้อมูลด้วย exclusion constraint แม้จะมีข้อผิดพลาดของแอปพลิเคชัน นัดหมายที่ชนกันก็ไม่สามารถถูกเขียนได้

การแย่งช่วงเวลาพร้อมกันถูกป้องกันด้วย distributed lock ของ Redis สองคำขอไม่สามารถเขียนลงในช่วงเวลาเดียวกันพร้อมกันได้

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

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

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

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

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

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

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

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

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

ติดต่อเรา