Lịch hẹn & Lịch

Lập lịch theo bác sĩ và ghế điều trị, ngăn đặt trùng, nhắc tự động và danh sách chờ. Xung đột được ngăn chặn ở cấp cơ sở dữ liệu.

Các endpoint thuộc tài nguyên này. Mỗi endpoint bị giới hạn trong dữ liệu phòng khám mà khóa API gắn với; các endpoint ghi hỗ trợ tiêu đề Idempotency-Key.

Ví dụ Sử dụng

Lấy cuộc hẹn theo khoảng thời gian

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

Bảo mật ở tài nguyên này

Bảo mật không phải là một tính năng, mà là chính kiến trúc. Những đảm bảo có hiệu lực tại tài nguyên này:

Định dạng Lỗi

Lỗi trả về trong một phong bì nhất quán; mã hướng đến máy, thông điệp hướng đến người dùng. Lỗi nội bộ/stack không bao giờ bị rò rỉ.

{
  "error": {
    "code": "validation_failed",
    "message": "Trường không hợp lệ: email"
  }
}

Tài nguyên khác