custombatch è un metodo comune che consente di raggruppare diverse chiamate API,
note come "voci" in un'unica richiesta HTTP. Ogni voce fa riferimento solo 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.
Effettuare richieste batch
L'invio di richieste batch è simile all'invio di chiamate API in parallelo. Tieni presente che non vi è alcuna garanzia che l'ordine delle voci definito nella richiesta sarà nell'ordine in cui sono state eseguite. Ti consigliamo di non utilizzare chiamate interdipendenti in una singola richiesta batch (ad esempio creando e aggiornando la stessa spedizione).
Allo stesso modo, le risposte ricevute per le richieste in batch potrebbero essere restituite in un
ordine diverso da quello delle voci della richiesta. L'elemento BatchId può essere utilizzato per
mettere in correlazione richieste e risposte, poiché le risposte potrebbero essere restituite
in modo fuori sequenza.
Puoi eseguire le richieste in 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, consigliamo di limitare le dimensioni
delle richieste custombatch a un massimo di 1000 voci. Alle 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."