custombatch to popularna metoda, która pozwala zgrupować kilka wywołań interfejsu API (nazywanych „wpisami”) w jednym żądaniu HTTP. Każdy wpis odwołuje się tylko do jednego wywołania metody.
Niestandardowa grupa wiekowa to dobry wybór, gdy:
- Dopiero zaczynasz używać interfejsu API i masz do przesłania dużo danych produktów.
- Musisz zsynchronizować lokalne dane z serwerem, wysyłając wiele aktualizacji i usunięcia.
Wysyłanie żądań zbiorczych
Wysyłanie żądań zbiorczych przypomina równoległe wywołania interfejsu API. Pamiętaj, że nie ma gwarancji, że kolejność wpisów zdefiniowana w żądaniu będzie ustalona w kolejności wykonywania. Nie zalecamy używania wywołań zależnych w pojedynczym żądaniu zbiorczym (np. tworzenia i aktualizowania tej samej wysyłki).
Podobnie odpowiedzi otrzymane w przypadku żądań zbiorczych mogą być zwracane w innej kolejności niż wpisy żądań. BatchId może służyć do skorelowania żądań i odpowiedzi, ponieważ odpowiedzi mogą być zwracane po kolei.
Możesz grupować żądania w interfejsie API, wywołując odpowiednią metodę custombatch:
| Zasoby i odpowiadające im niestandardowe metody wsadowe | |
|---|---|
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 |
Ograniczenia
Aby uniknąć błędów podczas przesyłania dużych wsadów, zalecamy ograniczenie rozmiaru żądań custombatch do maksymalnie 1000 wpisów. W przypadku żądań custombatch obowiązują te wartości maksymalne:
- 50 000 pozycji na żądanie
custombatch - Rozmiar transferu 32 MB
Wywołania przekraczające wartości maksymalne powodują request_too_large tych błędów:
"Too many requests in a batch.""Request payload size exceeds the limit: %d bytes."