批处理请求

custombatch 是一种常用的方法，您可以利用此方法将多个 API 调用（称为“条目”）组合到一个 HTTP 请求中。每个条目仅引用一个方法调用。

在以下情况下，自定义批处理是一种很好的选择：

• 您刚开始使用 API，并且需要上传大量商品数据。
• 您需要发送大量更新和删除操作，以与服务器同步本地数据。

进行批量请求

发送批处理请求类似于并行发送 API 调用。请注意，我们无法保证请求中定义的条目将按其执行顺序排列。我们建议您不要在单个批处理请求（例如创建和更新相同的运单）中使用相互依赖的调用。

类似地，针对批处理请求收到的响应，其返回的顺序可能与请求条目的顺序不同。BatchId 可用来将请求与响应相关联，因为这些响应可能不按顺序返回。

通过调用相应的 custombatch 方法，您可以在 API 中批处理请求：

限制

为避免在上传大型批处理时出错，我们建议您将 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."