Limitation de debit (Rate Limiting)
L'API Partenaire applique des limites de debit pour garantir une utilisation equitable et la stabilite de la plateforme.
Limites par defaut
| Endpoint | Limite (Production) | Limite (Bac a sable) |
|---|---|---|
| Endpoints generaux | 100 requetes/min | 500 requetes/min |
Creation de commande (POST /orders) | 10 requetes/min | 50 requetes/min |
En-tetes de reponse
Chaque reponse de l'API inclut des informations sur les limites de debit dans les en-tetes suivants :
| En-tete | Description |
|---|---|
X-RateLimit-Limit | Nombre maximum de requetes autorisees dans la fenetre actuelle |
X-RateLimit-Remaining | Nombre de requetes restantes dans la fenetre actuelle |
X-RateLimit-Reset | Horodatage Unix (en secondes) indiquant quand la fenetre de limitation se reinitialise |
Gestion des reponses 429
Lorsque vous depassez la limite de debit, l'API retourne une reponse 429 Too Many Requests :
{
"statusCode": 429,
"message": "Rate limit exceeded. Try again in 45 seconds.",
"error": "Too Many Requests"
}
Strategie recommandee
- Lisez l'en-tete
X-RateLimit-Remainingpour surveiller votre utilisation de maniere proactive. - Lorsque vous recevez un
429, attendez jusqu'au moment indique parX-RateLimit-Resetavant de reessayer. - Implementez un backoff exponentiel (exponential backoff) pour les nouvelles tentatives afin d'eviter une limitation repetee.
- Mettez en cache les reponses du catalogue de produits lorsque c'est possible pour reduire les requetes inutiles.