Chuyển Dữ liệu (Export API)

Chuyển dữ liệu có kiểm soát, chỉ đọc. Chỉ nhà điều hành nền tảng (SuperUser) mới định nghĩa kết nối + khóa cho một phòng khám; khóa trích xuất dữ liệu của phòng khám đó từ các tập dữ liệu "VEM" (view Mô hình Dữ liệu Tối thiểu) đã chọn. Không có quyền truy cập chéo giữa các tenant. Tuân thủ nghĩa vụ khả chuyển dữ liệu (Điều 14 của Quy định số 39682).

Hoạt động như thế nào?

Xác thực Danh tính

Mỗi yêu cầu phải mang một khóa xuất. Hai phương thức được hỗ trợ; khóa chỉ được lưu dưới dạng hash SHA-256.

Authorization: Bearer udx_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
— hoặc —X-Export-Key: udx_xxxxxxxxxxxxxxxxxxxxxxxxxxxx

Endpoint

Ví dụ Sử dụng

Trích xuất bệnh nhân (VEM)

curl https://udentiva.com/export/v1/patients?limit=1000 \
  -H "Authorization: Bearer udx_xxxxxxxx"

HTTP/1.1 200 OK
{
  "dataset": "patients",
  "count": 1000,
  "limit": 1000,
  "offset": 0,
  "rows": [ { "patient_id": "...", "tenant_id": "...", "first_name": "..." } ]
}

VEM Görüntüsü — Lược đồ View

Mỗi tập dữ liệu có thể chuyển giao đều là một VEM Görüntüsü (view Mô hình Dữ liệu Tối thiểu) với các cột cố định. Bên dưới là lược đồ cột đầy đủ, kiểu dữ liệu và (nếu có) trường VEM tương ứng của Bộ Y tế cho từng tập. Trường tiền trả về dạng thập phân (numeric), định danh là uuid, ngày tháng theo ISO-8601 (timestamptz).

Mô hình Bảo mật

Tài nguyên khác