批次處理要求

custombatch 是常見的方法,可讓您將多個 API 呼叫 (稱為「項目」) 分組至單一 HTTP 要求。每個項目只參照單一方法呼叫。

在下列情況下,自訂批次是個不錯的選擇:

  • 你剛開始使用 API,而且有大量產品資料要上傳。
  • 您必須傳送大量更新和刪除作業,才能將本機資料與伺服器保持同步。

發出批次要求

傳送批次要求與同時傳送 API 呼叫類似。請注意,我們不保證要求中定義的項目順序會是執行的順序。建議您不要在單一批次要求中使用相互依賴的呼叫 (例如建立和更新相同的出貨單)。

同樣地,針對批次要求收到的回應,其傳回順序可能與要求項目不同。BatchId 可用於比對要求和回應,因為回應可能會以不規則的順序傳回。

您可以呼叫適當的 custombatch 方法,在 API 中批次要求:

資源及其對應的自訂批次方法
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

限制

為避免上傳大量資料時發生錯誤,建議您將 custombatch 要求的大小限制在最多 1,000 個項目。以下限制適用於 custombatch 要求:

  • 每項 custombatch 要求 50,000 個項目
  • 32 MB 傳輸大小

超過上限的呼叫會導致下列 request_too_large 錯誤:

  • "Too many requests in a batch."
  • "Request payload size exceeds the limit: %d bytes."