일괄 요청

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개
  • 32MB 전송 크기

최대값을 초과하는 호출은 다음과 같은 request_too_large 오류를 발생시킵니다.

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