Limites de débit

Chaque clé peut faire 120 appels par minute, en production comme en bac à sable. Chaque réponse indique où vous en êtes :

RateLimit-Limit: 120
RateLimit-Remaining: 117
RateLimit-Reset: 42

• RateLimit-Limit : appels autorisés sur la fenêtre d’une minute.
• RateLimit-Remaining : appels restants.
• RateLimit-Reset : secondes avant la nouvelle fenêtre.

Au-delà

L’API répond 429 rate_limited avec l’en-tête Retry-After (en secondes). Attendez ce délai avant de reprendre ; lissez vos envois en masse plutôt que de les lancer en parallèle.

{
  "error": {
    "code": "rate_limited",
    "message": "Vous avez envoyé trop de requêtes. Merci de réessayer dans 42 s.",
    "details": {
      "retryAfter": 42
    }
  }
}

Autres limites

• Bac à sable : 1 000 appels par jour et par compte (429 test_quota_exceeded).
• Production : dépense limitée au crédit prépayé (402 insufficient_balance), voir crédit et facturation.
• Webhooks : 5 points de terminaison au plus par compte.
• Besoin de plus ? Écrivez à contact@vitef.com avec votre volume prévu.

Astuce : le catalogue (GET /v1/catalogue) renvoie un ETag. Renvoyez-le dans If-None-Match pour obtenir un 304 sans corps, et gardez-le en cache une journée.