custombatch, birkaç API çağrısını (girişler) tek bir HTTP isteğinde gruplandırmanıza olanak 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çimdir:
- API'yi kullanmaya başladınız ve yüklemeniz gereken çok miktarda ürün verisi var.
- Çok sayıda güncelleme ve silme göndererek yerel verileri sunucuyla senkronize etmeniz gerekir.
Toplu istek yapma
Toplu istekler göndermek, paralel olarak API çağrıları göndermeye benzer. İstekte tanımlanan girişlerin sırasının, yürütüldükleri sırada olacağına dair bir garanti olmadığını unutmayın. Tek bir toplu istekte (ör. aynı gönderimi oluşturup güncelleme) bağımsız çağrılar kullanmamanızı öneririz.
Benzer şekilde, toplu istekler için alınan yanıtlar, istek girişlerininkinden farklı bir sırada döndürülebilir. Yanıtlar sıralı dışında 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 istekleri toplu olarak gönderebilirsiniz:
| Kaynaklar ve bunlara karşılık gelen özel grup 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 hataları önlemek için custombatch isteklerinin boyutunu en fazla 1.000 girişle sınırlandırmanızı öneririz. custombatch istek için aşağıdaki maksimum değerler 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 hatayla sonuçlanır:
"Too many requests in a batch.""Request payload size exceeds the limit: %d bytes."