Limites de débit et nouvelles tentatives

​

À quoi s’attendre

• Une réponse 429 peut être renvoyée par n’importe quel endpoint, en général quand de nombreuses requêtes sont envoyées en très peu de temps.
• Ne vous fiez pas aux en-têtes de limite de débit (comme X-RateLimit-* ou Retry-After) : leur présence n’est pas garantie. Si un en-tête Retry-After est présent, attendez au moins la durée indiquée.
• Une réponse 429 signifie que la requête n’a pas été traitée. Vous pouvez la renvoyer plus tard sans risque.

​

Réessayer avec un backoff exponentiel

async function qwotyFetch(url, options = {}, maxAttempts = 5) {
  for (let attempt = 0; attempt < maxAttempts; attempt++) {
    const response = await fetch(url, {
      ...options,
      headers: {
        Authorization: `Bearer ${process.env.QWOTY_API_TOKEN}`,
        'Content-Type': 'application/json',
        ...options.headers,
      },
    })

    if (response.status !== 429 && response.status < 500) {
      return response
    }

    // 1s, 2s, 4s, 8s… plus up to 250 ms of jitter
    const delay = 1000 * 2 ** attempt + Math.random() * 250
    await new Promise((resolve) => setTimeout(resolve, delay))
  }
  throw new Error(`Qwoty API still failing after ${maxAttempts} attempts: ${url}`)
}

import os, random, time
import requests

def qwoty_request(method, url, max_attempts=5, **kwargs):
    headers = {'Authorization': f"Bearer {os.environ['QWOTY_API_TOKEN']}"}
    for attempt in range(max_attempts):
        response = requests.request(method, url, headers=headers, **kwargs)
        if response.status_code != 429 and response.status_code < 500:
            return response
        time.sleep(2 ** attempt + random.random() / 4)
    raise RuntimeError(f'Qwoty API still failing after {max_attempts} attempts: {url}')

​

Éviter les rafales

• Envoyez les requêtes séquentiellement ou avec une concurrence faible et fixe (quelques requêtes en parallèle), plutôt que d’en lancer des centaines d’un coup.
• Étalez les traitements de masse dans le temps. Pour les imports volumineux, traitez les enregistrements par lots avec une courte pause entre chaque lot. Pour un chargement initial ponctuel de produits et de prix, préférez l’import CSV de l’application (consultez Migration des données).
• Utilisez les endpoints de liste. Récupérez une liste en une fois (par exemple Lister les produits avec limit, ou Lister les prix avec limit et offset) plutôt qu’un GET par objet.
• Mettez en cache ce qui change rarement, comme les catalogues, les catégories et les conditions de paiement.
• Réagissez aux webhooks au lieu d’interroger l’API en boucle. Consultez Webhooks.

​

Besoin de plus de débit ?