Danh sách API
9 API, tất cả đều GET và chỉ đọc. Mọi đường dẫn bắt đầu bằng /api/integration/v1. Bấm vào mô tả để xem tham số, phản hồi và lỗi của API đó; mỗi nhóm cần một quyền riêng.
Lượt khám
| Mô tả | HTTP request |
|---|---|
| Lấy danh sách lượt khám | GET /encounters |
Bệnh nhân
| Mô tả | HTTP request |
|---|---|
| Lấy danh sách bệnh nhân | GET /patients |
| Lấy một bệnh nhân | GET /patients/{id} |
Lịch hẹn
| Mô tả | HTTP request |
|---|---|
| Lấy danh sách lịch hẹn | GET /appointments |
| Lấy một lịch hẹn | GET /appointments/{id} |
Hóa đơn
| Mô tả | HTTP request |
|---|---|
| Lấy danh sách hóa đơn | GET /receipts |
| Lấy một hóa đơn | GET /receipts/{id} |
Liệu trình
| Mô tả | HTTP request |
|---|---|
| Lấy danh sách liệu trình | GET /therapy-plans |
| Lấy một liệu trình | GET /therapy-plans/{id} |
Bốn danh sách bệnh nhân, lịch hẹn, hóa đơn và liệu trình chia trang bằng con trỏ và lọc được theo updatedSince; lượt khám chia trang bằng số trang. Xem Phân trang và Đồng bộ liên tục.
BASE=https://iclinic.phongkhamhieploi.vn/api/integration/v1
AUTH="Authorization: Bearer $ICLINIC_API_KEY"
# Lượt khám theo ngày (phân trang page / pageSize)
curl -sS -H "$AUTH" "$BASE/encounters?from=2026-09-14&to=2026-09-19"
# Bốn danh sách còn lại (phân trang cursor / limit)
curl -sS -H "$AUTH" "$BASE/patients?limit=200"
curl -sS -H "$AUTH" "$BASE/appointments?limit=200"
curl -sS -H "$AUTH" "$BASE/receipts?limit=200"
curl -sS -H "$AUTH" "$BASE/therapy-plans?limit=200"
# Một bản ghi theo id (lấy id từ danh sách), ví dụ bệnh nhân
curl -sS -H "$AUTH" "$BASE/patients/$PATIENT_ID"