custombatch là một phương thức phổ biến cho phép bạn nhóm một số lệnh gọi API (được gọi là "mục") thành một yêu cầu HTTP duy nhất. Mỗi mục nhập chỉ tham chiếu đến một lệnh gọi phương thức duy nhất.
Bạn nên chọn lô tuỳ chỉnh khi:
- Bạn mới bắt đầu sử dụng API và có nhiều dữ liệu sản phẩm cần tải lên.
- Bạn cần đồng bộ hoá dữ liệu cục bộ với máy chủ bằng cách gửi nhiều nội dung cập nhật và xoá.
Đưa ra yêu cầu theo lô
Gửi yêu cầu theo lô tương tự như gửi các lệnh gọi API song song. Xin lưu ý rằng không có gì đảm bảo rằng thứ tự của các mục được xác định trong yêu cầu sẽ theo thứ tự mà chúng được thực thi. Bạn không nên sử dụng các lệnh gọi phụ thuộc lẫn nhau trong một yêu cầu hàng loạt (chẳng hạn như tạo và cập nhật cùng một lô hàng).
Tương tự, các phản hồi nhận được cho các yêu cầu theo lô có thể được trả về theo một thứ tự khác so với thứ tự của các mục nhập yêu cầu. Bạn có thể dùng BatchId để tương quan các yêu cầu và phản hồi vì các phản hồi có thể được trả về ngoài trình tự.
Bạn có thể gửi yêu cầu theo lô trong API bằng cách gọi phương thức custombatch thích hợp:
| Tài nguyên và các phương thức tương ứng cho lô tuỳ chỉnh | |
|---|---|
Accounts |
accounts.custombatch |
Accountstatuses |
accountstatuses.custombatch |
Accounttax |
accounttax.custombatch |
Datafeeds |
datafeeds.custombatch |
Datafeedstatuses |
datafeedstatuses.custombatch |
Localinventory |
localinventory.custombatch
|
Liasettings |
liasettings.custombatch |
Pos |
pos.custombatch |
Products |
products.custombatch |
Productstatuses |
productstatuses.custombatch |
Shippingsettings |
shippingsettings.custombatch |
Giới hạn
Để tránh lỗi khi tải các lô lớn lên, bạn nên giới hạn kích thước của các yêu cầu custombatch tối đa là 1.000 mục. Các giá trị tối đa sau đây áp dụng cho yêu cầu custombatch:
- 50.000 mục nhập cho mỗi yêu cầu
custombatch - Kích thước cần chuyển là 32 MB
Các lệnh gọi vượt quá mức tối đa sẽ dẫn đến các lỗi request_too_large sau:
"Too many requests in a batch.""Request payload size exceeds the limit: %d bytes."