API công khai

Duyệt qua kết quả và ở trong giới hạn

Các điểm cuối danh sách phân trang bằng con trỏ chứ không bằng offset, nên hãy đi theo con trỏ mà phản hồi đưa cho bạn thay vì tự tính. Để mắt tới các header giới hạn tần suất, và dùng updatedSince để dò thay vì đọc lại tất cả.

Đã rà soát 20 tháng 8, 2026

Các bước

1. Đi theo con trỏ của từng phản hồi cho tới khi không còn con trỏ nào trả về. Đừng tự dựng con trỏ.
2. Giữ cỡ trang ở mức hợp lý — trang lớn hơn nghĩa là ít yêu cầu hơn, nhưng chậm hơn.
3. Dò bằng updatedSince thay vì duyệt cả bộ sưu tập theo lịch.
4. Đọc header giới hạn tần suất và chậm lại trước khi bị từ chối, chứ không phải sau đó.
5. Lưu requestId của mọi thứ thất bại, để đưa bộ phận hỗ trợ.

Cách kiểm chứng kết quả

Một lượt duyệt trọn vẹn trả về mỗi đối tượng đúng một lần, và việc dò lặp lại chỉ đọc phần đã thay đổi.

Chỗ thường sai

• Dựng trang theo offset, thứ trượt đi khi dữ liệu bên dưới thay đổi.
• Đọc lại tất cả mỗi phút rồi đâm vào giới hạn.
• Dùng lại một con trỏ cũ và nhận lỗi con trỏ không hợp lệ.