Limites de débit

Ikawaari applique des limites de débit pour garantir un usage équitable et la stabilité de la plateforme.

Limites par défaut

Scope	Limit
Par clé API	100 requêtes/minute (configurable)
Par marchand (toutes clés)	1 000 requêtes/minute
Événements de test webhook	10 requêtes/minute

Headers de limite de débit

Chaque réponse API inclut des headers de limite de débit :

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1708300860

Lorsque vous atteignez la limite

Vous recevez une réponse 429 Too Many Requests :

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests. Please retry after 12 seconds.",
    "type": "api_error"
  }
}

Bonnes pratiques

• Implémentez un backoff exponentiel pour les retries
• Mettez les réponses en cache lorsque c’est possible
• Utilisez les webhooks au lieu de faire du polling pour les mises à jour de statut
• Demandez une augmentation de limite si vous avez besoin d’un débit plus élevé — contactez support@ikawaari.com