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

Labo

Tạo đơn hàng lab và theo dõi trạng thái từ đầu đến cuối; quản lý các phòng lab có hợp đồng. Phát hiện chậm trễ sớm.

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

Endpoint

7 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/lab-orders Liệt kê các đơn hàng lab Người dùng được ủy quyền
POST /v1/lab-orders Tạo đơn hàng lab Người dùng được ủy quyền
GET /v1/lab-orders/{id} Lấy chi tiết đơn hàng Người dùng được ủy quyền
PUT /v1/lab-orders/{id} Cập nhật đơn hàng Người dùng được ủy quyền
POST /v1/lab-orders/{id}/status Thay đổi trạng thái đơn hàng Người dùng được ủy quyền
GET /v1/labs Liệt kê các phòng lab có hợp đồng Người dùng được ủy quyền
POST /v1/labs Thêm phòng lab Người dùng được ủy quyền

Ví dụ Sử dụng

Tạo đơn hàng lab

Yêu cầu
curl -X POST https://api.udentiva.com/v1/lab-orders \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"patient_id":"c0ffee00-...","lab_id":"lab-3","type":"crown"}'
Phản hồi
HTTP/1.1 201 Created
{
  "id": "lo-204",
  "status": "created",
  "created_at": "2026-06-24T09:25: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:

Đơn hàng lab và hồ sơ phòng lab được cô lập theo phòng khám của bạn (RLS).
Chuyển tiếp trạng thái được thực hiện bằng action endpoint và được ghi vào nhật ký kiểm toán.
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 Hình ảnh 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ệ