Yêu cầu theo lô

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òn gọi là "mục nhập") vào một yêu cầu HTTP duy nhất. Mỗi mục chỉ tham chiếu đến một lệnh gọi phương thức.

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 bản cập nhật và xoá.

Tạo yêu cầu hàng loạt

Việc gửi yêu cầu hàng loạt tương tự như việc gửi các lệnh gọi API song song. Xin lưu ý rằng chúng tôi không đảm bảo rằng thứ tự của các mục nhập được xác định trong yêu cầu sẽ là thứ tự thực thi các mục nhập đó. 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 thứ tự khác với các mục yêu cầu. Bạn có thể sử dụng BatchId để liên kết các yêu cầu và phản hồi vì các phản hồi có thể được trả về không theo 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à phương thức tuỳ chỉnh theo lô tương ứng
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 lên hàng loạt lớn, bạn nên giới hạn kích thước của các yêu cầu custombatch ở mức tối đa là 1.000 mục nhập. Các giá trị tối đa sau đây áp dụng cho các yêu cầu custombatch:

  • 50.000 mục nhập cho mỗi yêu cầu custombatch
  • Kích thước chuyển 32 Mb

Các lệnh gọi vượt quá giới hạn 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."