Rate limiting

L'API Coffrify applique des limites de taux par clé API sur une fenêtre glissante de 60 secondes.

Limites par plan

• **Free** - 30 req/min
• **Pro** - 300 req/min
• **Ultra** - 1 000 req/min
• **Clé test** - illimité (sandbox, ne compte pas en production)

Headers de contrôle

Chaque réponse inclut ces headers, même sur les succès :

X-RateLimit-Limit: 300
X-RateLimit-Remaining: 247
X-RateLimit-Reset: 1717012860
Retry-After: 14   # présent uniquement sur 429

Réponse 429

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests. Retry after 14 seconds.",
    "retry_after": 14
  }
}

Bonnes pratiques

• Lisez `X-RateLimit-Remaining` avant chaque requête dans les boucles.
• Sur 429, attendez exactement `Retry-After` secondes avant de réessayer.
• Utilisez des clés **test** pour le CI/CD - elles ne consomment pas votre quota live.
• Regroupez les créations de transferts en batch quand possible (endpoint `/v1/transfers/batch` disponible sur Pro+).