Portées et limites de débit
Une clé ne porte que les portées accordées. Demandez ce que l’intégration utilise ; la page de consentement décrit chaque portée en mots simples et les boutiques refusent les demandes trop larges.
Portée
| Portée | Permet |
|---|---|
| offers.manage | Rapprocher ou proposer des produits, créer et modifier offres et prix. |
| catalog.media | Importer des images par URL ou envoi signé, les attacher aux produits. |
| inventory.adjust | Fixer le stock disponible par SKU, en lot ou un par un. |
| orders.read | Lire les commandes Wamia, leurs tranches et l’historique des statuts. |
| orders.fulfil | Accuser réception des tranches, les marquer préparées, déclarer les envois entrants et réserver des créneaux. |
| returns.handle | Lire les RMA et enregistrer la décision de la boutique. |
| finance:read | Solde, versements et relevés. |
| performance:read | Indicateurs boutique : ventes, part de Buy Box, défauts. |
| settings:write | Réglages de boutique que le plugin reflète (délai de préparation, congés). |
| webhooks.manage | Créer, tester, suspendre et rejouer des points de webhook. |
Limites de débit
Quatre seaux à jetons par clé, remplis en continu et partagés entre toutes les instances de l’API : lectures, écritures, écritures en lot et budget quotidien. Les clés connecteur ont le grand budget ; les clés personnalisées démarrent au petit et les boutiques peuvent en demander plus.
| Nom | Clé personnalisée | Clé connecteur |
|---|---|---|
| Lectures | 60 par minute | 600 par minute |
| Écritures | 60 par minute | 300 par minute |
| Écritures en lot | 5 par minute | 20 par minute |
| Budget quotidien | 20 000 par jour | 200 000 par jour |
Une mutation en lot compte une fois sur le seau lot quelle que soit sa taille, et une fois par élément sur le budget quotidien. Seau vide : l’appel répond
RATE_LIMITED avec extensions.retryAfterSeconds ; respectez-le et ajoutez de l’aléa.Limites des lots
- Jusqu’à 200 éléments par appel pour
apiUpsertOffers,apiDeclareStocksetapiMatchListings; au-delà,BATCH_TOO_LARGE. - Jusqu’à 20 URL d’images par appel
apiIngestMediaFromUrls, 10 Mo par image, 12 images par produit. - Prix en millimes entiers ; quantités entières jusqu’à 10 000 000.
- Les pages à curseur renvoient au plus 200 éléments ;
nextCursorest opaque — ne le construisez jamais vous-même. - Les clés d’idempotence font 8 à 128 caractères et sont conservées 7 jours ; un rejeu dans cette fenêtre renvoie la réponse mémorisée.
- Au plus 10 points de webhook par clé.