custombatch est une méthode courante qui vous permet de regrouper plusieurs appels d'API, ou "entrées", dans une seule requête HTTP. Chaque entrée ne fait référence qu'à un seul appel de méthode.
Nous vous recommandons d'utiliser cette méthode dans les cas suivants:
- Vous venez de commencer à utiliser l'API et vous avez de nombreuses données produit à importer.
- Vous devez synchroniser les données locales avec le serveur en envoyant de nombreuses mises à jour et suppressions.
Envoyer des requêtes par lot
Envoyer des requêtes par lot revient à envoyer des appels d'API en parallèle. Notez qu'il n'y a aucune garantie que les entrées soient exécutées dans l'ordre défini dans la requête. Nous vous recommandons de ne pas utiliser d'appels interdépendants dans une seule requête par lot (par exemple, pour créer et mettre à jour une même livraison).
De même, les réponses reçues pour les requêtes par lot peuvent être renvoyées dans un ordre différent de celui des entrées de la requête. BatchId peut être utilisé pour corréler les requêtes et les réponses, car les réponses peuvent être renvoyées dans le désordre.
Vous pouvez envoyer des requêtes par lot dans l'API en appelant la méthode custombatch appropriée:
| Ressources et méthodes de traitement par lot personnalisées correspondantes | |
|---|---|
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 |
Limites
Pour éviter les erreurs lors de l'importation de lots volumineux, nous vous recommandons de limiter la taille des requêtes custombatch à 1 000 entrées au maximum. Les valeurs maximales suivantes s'appliquent aux requêtes custombatch:
- 50 000 entrées par requête
custombatch - Taille de transfert de 32 Mo
Les appels qui dépassent les valeurs maximales entraînent les erreurs request_too_large suivantes:
"Too many requests in a batch.""Request payload size exceeds the limit: %d bytes."