custombatch, "girişler" olarak bilinen çeşitli API çağrılarını tek bir HTTP isteğinde gruplandırmanıza imkan tanıyan yaygın bir yöntemdir. Her giriş, yalnızca tek bir yöntem çağrısına referans verir.
Aşağıdaki durumlarda özel grup iyi bir seçenektir:
- API'yi kullanmaya yeni başladınız ve yüklenecek çok fazla ürün veriniz var.
- Çok sayıda güncelleme ve silme göndererek yerel verileri sunucuyla senkronize etmeniz gerekir.
Toplu istekler yapma
Toplu istek gönderme, paralel olarak API çağrıları göndermeye benzer. İstekte tanımlanan girişlerin sırasının, yürütüldüğü sıranın olacağına dair bir garanti olmadığını unutmayın. Birbirine bağlı çağrıları tek bir toplu istekte (ör. aynı kargoyu oluşturma ve güncelleme) kullanmamanızı öneririz.
Benzer şekilde, toplu istekler için alınan yanıtlar, istek girişlerinden farklı bir sırada döndürülebilir. Yanıtlar sıralı olarak döndürülebileceği için BatchId, istekleri ve yanıtları ilişkilendirmek için kullanılabilir.
Uygun custombatch yöntemini çağırarak API'de toplu istek gönderebilirsiniz:
| Kaynaklar ve bunlara karşılık gelen özel toplu işlem yöntemleri | |
|---|---|
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 |
Sınırlar
Büyük gruplar yüklerken hata olmaması için custombatch isteklerinin boyutunu en fazla 1.000 girişle sınırlandırmanızı öneririz. Aşağıdaki maksimum değerler custombatch istekleri için geçerlidir:
custombatchisteği başına 50.000 giriş- 32 Mb aktarım boyutu
Maksimum değerleri aşan çağrılar aşağıdaki request_too_large hatalarına neden olur:
"Too many requests in a batch.""Request payload size exceeds the limit: %d bytes."