Báo cáo & BI

Lấy trực tiếp các chỉ số doanh thu, tỷ lệ lấp đầy, chuyển đổi và lợi nhuận. Mọi con số đều được suy ra từ dữ liệu thực của phòng khám bạn.

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 các chỉ số trí tuệ kinh doanh

curl https://api.udentiva.com/v1/bi?period=2026-06 \
  -H "Authorization: Bearer udk_live_xxx"

HTTP/1.1 200 OK
{
  "occupancy": 0.78,
  "no_show_rate": 0.06,
  "collected": "248500.00"
}

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