custombatch è un metodo comune che consente di raggruppare diverse chiamate API, note come "entries", in un'unica richiesta HTTP. Ogni voce fa riferimento solo a una
chiamata a metodo singolo.
Il batch personalizzato è una buona scelta quando:
- Hai appena iniziato a utilizzare l'API e hai molti dati di prodotto da caricare.
- Devi sincronizzare i dati locali con il server inviando molti aggiornamenti ed eliminazioni.
Esecuzione di richieste batch
L'invio di richieste batch è simile all'invio in parallelo di chiamate API. Tieni presente che non è garantito che l'ordine delle voci definite nella richiesta sia nell'ordine in cui vengono eseguite. Ti consigliamo di non utilizzare chiamate interdipendenti in una singola richiesta batch (ad esempio creare e aggiornare la stessa spedizione).
Analogamente, le risposte ricevute per le richieste in batch possono essere restituite in un ordine diverso da quello delle voci di richiesta. BatchId può essere utilizzato per correlare richieste e risposte, poiché le risposte possono essere restituite fuori sequenza.
Puoi raggruppare le richieste nell'API chiamando il metodo custombatch appropriato:
| Risorse e metodi batch personalizzati corrispondenti | |
|---|---|
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 |
Limiti
Per evitare errori durante il caricamento di batch di grandi dimensioni, consigliamo di limitare le dimensioni delle richieste custombatch a un massimo di 1000 voci. Per le richieste custombatch si applicano i seguenti valori massimi:
- 50.000 voci per richiesta
custombatch - Dimensione di trasferimento 32 Mb
Le chiamate che superano i valori massimi generano i seguenti errori request_too_large:
"Too many requests in a batch.""Request payload size exceeds the limit: %d bytes."