Vero OMS API

Chuẩn hóa yêu cầu

Khuyến nghị	Lý do
Gửi request nhỏ nhất có ích	Phản hồi nhỏ hơn và dễ gỡ lỗi hơn
Truyền `limit` hợp lý	Tránh lấy nhiều dữ liệu hơn cần thiết
Theo đúng kiểu phân trang của endpoint	Dùng `limit`, `offset` hoặc tham số khoảng thời gian đúng như tài liệu
Cache dữ liệu ít thay đổi	Cấu hình và metadata tham chiếu không cần tải lại liên tục
Thử lại với backoff	Tránh gửi lại dồn dập khi có lỗi tạm thời

Trường hợp sử dụng	Gợi ý
Màn hình danh sách	Chỉ request các field và page size cần cho UI
Màn hình chi tiết	Fetch bằng định danh tài nguyên ổn định
Đồng bộ nền	Dùng phân trang và lưu tiến độ ở phía client
Lỗi tạm thời	Retry với exponential backoff và giới hạn số lần retry

Gửi yêu cầu đầu tiên

Truyền limit phù hợp với giao diện hoặc kích thước lô xử lý.

Kiểm tra phản hồi

Xác định phản hồi đã đủ dữ liệu cho màn hình hoặc lô xử lý hiện tại chưa.

Yêu cầu trang kế tiếp

Tăng offset hoặc dịch khoảng thời gian theo trang tham chiếu của endpoint đó.

Status	Cách xử lý
`400`	Sửa tham số truy vấn hoặc định dạng thời gian
`401`	Kiểm tra thông tin xác thực của tài khoản
`404`	Kiểm tra ID tài nguyên hoặc đường dẫn đang yêu cầu
`429`	Giảm tần suất và thử lại sau
`503`	Thử lại với backoff sau một khoảng ngắn

⌘I