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

Bệnh nhân

Hồ sơ bệnh nhân: thông tin nhân khẩu học, bệnh sử/dị ứng, tiền sử y tế và tài liệu. Mỗi bản ghi được cô lập theo phòng khám của bạn; thao tác xóa là lưu trữ có thể khôi phục (không hard-delete).

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

Endpoint

9 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 Lấy danh sách bệnh nhân theo trang Tất cả các vai trò được ủy quyền
POST /v1/patients Tạo hồ sơ bệnh nhân mới admin · thư ký · bác sĩ
GET /v1/patients/{id} Lấy chi tiết của một bệnh nhân Tất cả các vai trò được ủy quyền
PUT /v1/patients/{id} Cập nhật thông tin bệnh nhân admin · thư ký · bác sĩ
DELETE /v1/patients/{id} Lưu trữ bệnh nhân (soft-delete) admin
GET /v1/patients/{id}/medical Liệt kê bệnh sử, dị ứng và tiền sử y tế Tất cả các vai trò được ủy quyền
POST /v1/patients/{id}/medical Thêm bản ghi y tế/bệnh sử admin · bác sĩ
GET /v1/patients/{id}/documents Liệt kê tài liệu của bệnh nhân Tất cả các vai trò được ủy quyền
POST /v1/patients/{id}/documents Thêm tài liệu cho bệnh nhân admin · thư ký

Ví dụ Sử dụng

Tạo bệnh nhân mới

Yêu cầu
curl -X POST https://api.udentiva.com/v1/patients \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Idempotency-Key: 9f1c2e7a-..." \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Ayse","last_name":"Yilmaz","phone":"+90555..."}'
Phản hồi
HTTP/1.1 201 Created
{
  "id": "c0ffee00-1234-...",
  "first_name": "Ayse",
  "last_name": "Yilmaz",
  "phone": "+90555...",
  "created_at": "2026-06-24T09:00: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ô lập dữ liệu: tất cả truy vấn bệnh nhân được giới hạn ở cấp dòng (RLS) theo phòng khám mà khóa gắn với; bệnh nhân của phòng khám khác không bao giờ được trả về.
Phân quyền theo vai trò: tạo/cập nhật là admin, thư ký hoặc bác sĩ; xóa chỉ dành cho admin. Quyền được thực thi ở tầng API.
Dữ liệu nhạy cảm (TCKN, dữ liệu y tế) được che giấu và không ghi thô vào nhật ký kiểm toán.
Xóa = soft-delete (deleted_at); bản ghi được ẩn danh, không bị xóa vật lý (tuân thủ KVKK).
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

Lịch hẹn & Lịch Odontogram & Điều trị Thu tiền & Tài chính Kho Hình ảnh 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ệ