Phân trang

Danh sách nào cũng trả từng trang một. Mỗi API dùng một trong hai kiểu:

Con trỏ: bệnh nhân, lịch hẹn, hóa đơn, liệu trình

1. Gọi lần đầu, chỉ cần limit (1–500, mặc định 200).
2. Phản hồi có nextCursor. Nếu khác null là còn trang sau: gọi lại và thêm cursor= cùng giá trị đó.
3. Lặp lại tới khi nextCursor là null.

• Giữ nguyên limit và updatedSince (nếu có) ở mọi trang.
• Lấy nextCursor nguyên văn, đừng tự dựng hay đọc nó. cursor sai trả 400 INVALID_CURSOR.
• Kết quả xếp theo (updatedAt, id) tăng dần. Bản ghi được thêm hay sửa giữa hai lần gọi không làm lệch trang sau: bản ghi chưa đổi không bị bỏ sót hay lặp lại, còn bản ghi vừa đổi sẽ hiện lại một lần ở vị trí mới.

Số trang: /encounters

Dùng page (từ 0) và pageSize (1–500, mặc định 200). Tăng page cho tới khi đã nhận đủ total lượt khám, hoặc gặp một trang rỗng.

Kết quả xếp mới nhất trước. Nếu có lượt khám mới được tạo trong lúc bạn đang duyệt, các trang có thể dịch chuyển — vì vậy hãy khử trùng theo encounterUuid khi gộp kết quả.

# lần đầu chưa có cursor: bỏ tham số này
cursor = null
lặp:
    page = GET /patients?limit=500&cursor=CURSOR
    xử lý từng bản ghi trong page.patients
    cursor = page.nextCursor
    nếu cursor là null: dừng