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."