custombatch è un metodo comune che consente di raggruppare più chiamate API, note come "voci", in un'unica richiesta HTTP. Ogni voce fa riferimento a una singola chiamata di metodo.
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.
Eseguire richieste batch
L'invio di richieste batch è simile all'invio di chiamate API in parallelo. Tieni presente che non è garantito che l'ordine delle voci definite nella richiesta corrisponda all'ordine di esecuzione. Ti consigliamo di non utilizzare chiamate interdipendenti in una singola richiesta batch (ad esempio la creazione e l'aggiornamento della stessa spedizione).
Allo stesso modo, le risposte ricevute per le richieste batch potrebbero essere restituite in un ordine diverso rispetto a quello delle voci della richiesta. Il BatchId può essere utilizzato per correlare richieste e risposte, poiché le risposte potrebbero essere restituite in sequenza.
Puoi eseguire richieste batch nell'API chiamando il metodo custombatch appropriato:
| Risorse e relativi metodi batch personalizzati | |
|---|---|
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, ti consigliamo di limitare le dimensioni delle richieste custombatch a un massimo di 1000 voci. I seguenti valori massimi si applicano alle richieste custombatch:
- 50.000 voci per richiesta
custombatch - Dimensioni 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."