TÀI NGUYÊN API

Odontogram & Điều trị

Bản đồ răng FDI, danh mục dịch vụ/thủ thuật, kế hoạch điều trị theo giai đoạn và đơn thuốc. Trạng thái răng được giữ dưới dạng append-only — lịch sử không bị xóa, không bị ghi đè.

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

Endpoint

14 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}/odontogram Lấy bản đồ răng FDI hiện tại Tất cả các vai trò được ủy quyền

POST /v1/patients/{id}/odontogram Thêm trạng thái răng (append-only) admin · bác sĩ

GET /v1/patients/{id}/odontogram/{tooth}/history Lấy lịch sử trạng thái của một chiếc răng Tất cả các vai trò được ủy quyền

GET /v1/services Liệt kê danh mục dịch vụ/thủ thuật Tất cả các vai trò được ủy quyền

POST /v1/services Thêm hạng mục dịch vụ admin

PUT /v1/services/{id} Cập nhật hạng mục dịch vụ admin

GET /v1/patients/{id}/plans Liệt kê các kế hoạch điều trị của bệnh nhân Tất cả các vai trò được ủy quyền

POST /v1/patients/{id}/plans Tạo kế hoạch điều trị admin · bác sĩ

GET /v1/plans/{id} Lấy chi tiết kế hoạch điều trị Tất cả các vai trò được ủy quyền

POST /v1/plans/{id}/status Thay đổi trạng thái kế hoạch admin · bác sĩ

POST /v1/plans/{id}/items Thêm giai đoạn/hạng mục vào kế hoạch admin · bác sĩ

POST /v1/plan-items/{id}/status Thay đổi trạng thái hạng mục kế hoạch admin · bác sĩ

GET /v1/patients/{id}/prescriptions Liệt kê các đơn thuốc Tất cả các vai trò được ủy quyền

POST /v1/patients/{id}/prescriptions Tạo đơn thuốc admin · bác sĩ

Ví dụ Sử dụng

Thêm trạng thái răng (append-only)

Yêu cầu

curl -X POST https://api.udentiva.com/v1/patients/{id}/odontogram \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"tooth":"11","state":"caries","surface":"mesial"}'

Phản hồi

HTTP/1.1 201 Created
{
  "id": "st-77",
  "tooth": "11",
  "state": "caries",
  "recorded_at": "2026-06-24T09:10: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 bản ghi trạng thái răng là append-only: mỗi thay đổi được thêm dưới dạng một dòng mới, bản ghi cũ không thể thay đổi (tính toàn vẹn của lịch sử lâm sàng).

Việc tạo kế hoạch điều trị và đơn thuốc chỉ mở cho vai trò admin/bác sĩ; logic giá và giai đoạn được xử lý trên máy chủ.

Tất cả các bản ghi được cô lập theo phòng khám của bạn; các phép tính giá kế hoạch không lấy từ client mà được thực hiện trên máy chủ bằng numeric.

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 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ệ