UDENTIVA Nền tảng Quản lý Nha khoa Thông minh
TÀI NGUYÊN API

Hình ảnh

X-quang và ảnh lâm sàng được liên kết với hồ sơ bệnh nhân. Các tệp được lưu trong kho lưu trữ đối tượng tương thích S3; không bao giờ trong cơ sở dữ liệu.

Truy cập sớm Toàn bộ API

Endpoint

3 endpoint

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.

GET /v1/patients/{id}/images Liệt kê hình ảnh (X-quang/ảnh) của bệnh nhân Tất cả các vai trò được ủy quyền
POST /v1/patients/{id}/images Tải lên hình ảnh (S3, stream/presigned) admin · bác sĩ · thư ký
GET /v1/images/{id}/raw Tải xuống tệp hình ảnh (presigned) Tất cả các vai trò được ủy quyền

Ví dụ Sử dụng

Liệt kê hình ảnh của bệnh nhân

Yêu cầu
curl https://api.udentiva.com/v1/patients/{id}/images \
  -H "Authorization: Bearer udk_live_xxx"
Phản hồi
HTTP/1.1 200 OK
[
  {
    "id": "img-55",
    "kind": "panoramic",
    "url": "https://s3.../signed?expires=...",
    "created_at": "2026-06-24T09:20:00Z"
  }
]

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:

Các tệp lớn (X-quang) không được ghi vào đĩa của BFF; chúng được stream/presigned trực tiếp lên S3.
Quyền truy cập tệp thô được cấp bằng liên kết ký có thời hạn (presigned); ngay cả khi liên kết bị rò rỉ, nó cũng sẽ hết hạn.
Tất cả hình ảnh được cô lập theo bệnh nhân và phòng khám (RLS); phòng khám không được ủy quyền không thể truy cập.
Toàn bộ mô hình bảo mật →

Đị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

Bệnh nhân Lịch hẹn & Lịch Odontogram & Điều trị Thu tiền & Tài chính Kho Labo Lead & CRM Du lịch Y tế Báo cáo & BI Webhooks Chuyển Dữ liệu (Export API)
Bạn muốn có quyền truy cập sớm?
Là người đầu tiên biết khi API mở.
Liên hệ