Webhooks

เมื่อมีเหตุการณ์เกิดขึ้นในคลินิกของคุณ ระบบจะส่งการแจ้งเตือนที่ลงนามไปยังที่อยู่ที่บันทึกไว้ คุณจึงอัปเดตระบบของคุณเองให้เป็นปัจจุบันแบบทันที

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

เอนด์พอยต์

3 เอนด์พอยต์

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

GET /v1/webhooks แสดงรายการการสมัครสมาชิก webhook ที่บันทึกไว้ admin

POST /v1/webhooks บันทึก webhook สำหรับการแจ้งเตือนเหตุการณ์ admin

DELETE /v1/webhooks/{id} ลบการสมัครสมาชิก webhook admin

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

บันทึก webhook

คำขอ

curl -X POST https://api.udentiva.com/v1/webhooks \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://siz.example/hook","events":["payment.created"]}'

การตอบกลับ

HTTP/1.1 201 Created
{
  "id": "wh-1",
  "url": "https://siz.example/hook",
  "events": ["payment.created"],
  "secret": "whsec_xxx"
}

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

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

ทุกการแจ้งเตือนถูกลงนามด้วยคีย์ลับที่ใช้ร่วมกัน (HMAC) โดยการตรวจสอบลายเซ็นคุณจะยืนยันได้ว่าคำขอมาจาก UDENTIVA จริง

ปลอดภัยต่อการส่งซ้ำ: ทุกเหตุการณ์มีรหัสประจำตัวที่ไม่ซ้ำกัน คุณสามารถคัดกรองการส่งซ้ำออกจากรหัสได้ (การบริโภคแบบ idempotent)

การสมัครสมาชิก webhook ถูกแยกให้เฉพาะคลินิกของคุณ คุณจะได้รับเฉพาะเหตุการณ์ของคุณเองเท่านั้น

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

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

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

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

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

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

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

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

ติดต่อเรา