Phiên bản & thay đổi

Phiên bản nằm trong đường dẫn (/v1). Trong cùng một phiên bản, thay đổi chỉ theo hướng bổ sung: thêm trường trong phản hồi, thêm giá trị enum hoặc tham số tuỳ chọn. Thay đổi làm hỏng tương thích sẽ ra phiên bản mới (/v2).

Vì vậy client nên: bỏ qua trường lạ, và không giả định danh sách giá trị của status là cố định.

Nhật ký thay đổi

2026-11-01 1.1.0

Thêm quyền đọc (scope) cho API key. Thêm GET /patients, /appointments, /receipts, /therapy-plans và GET …/{id} của từng loại, đồng bộ bằng updatedSince và con trỏ. /encounters thêm patientId, followUpDate, updatedAt. Vẫn là /v1; key cũ giữ nguyên quyền encounters:read.

2026-09-19 1.0.0

Phát hành đầu tiên: GET /encounters xác thực bằng API key cố định, có phân trang và rate limit. Thay thế cho API lượt khám của Medi (đã ngừng hoạt động).

https://iclinic.phongkhamhieploi.vn/developers/openapi.json

# Nhập vào Postman, Insomnia hoặc trình sinh mã:
npx @openapitools/openapi-generator-cli generate \
  -i https://iclinic.phongkhamhieploi.vn/developers/openapi.json \
  -g typescript-fetch -o ./iclinic-client