Ce guide documente les limites techniques et opérationnelles de l’API CaurisFlux.
Rate limiting
L’API impose des limites sur le nombre de requêtes pour garantir la stabilité du service.
Limites par défaut
| Ressource | Limite |
|---|
| Requêtes API | Variable selon le plan |
| Webhooks sortants | Variable selon le plan |
Les limites exactes dépendent de votre plan tarifaire. Contactez le support pour connaître vos limites actuelles ou demander une augmentation.
En-têtes de réponse
Les réponses API incluent des en-têtes indiquant votre consommation :
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1705312800
| En-tête | Description |
|---|
X-RateLimit-Limit | Nombre maximum de requêtes par fenêtre |
X-RateLimit-Remaining | Requêtes restantes |
X-RateLimit-Reset | Timestamp Unix de réinitialisation |
Gestion du rate limiting
Quand la limite est atteinte, l’API retourne :
Code HTTP : 429 Too Many Requests
Stratégie recommandée :
Limites de montant
Limites par transaction
Les montants minimum et maximum varient selon le provider et le pays.
| Paramètre | Valeur typique |
|---|
| Montant minimum | 100 (XOF/XAF) |
| Montant maximum | 1 000 000 - 2 000 000 (selon provider) |
Consultez le guide Mobile Money pour les limites détaillées par provider et par pays. Limites par compte
Des limites journalières ou mensuelles peuvent s’appliquer selon votre compte et votre plan. Ces limites sont configurées dans le Dashboard.
Limites des webhooks
Timeout
Les webhooks doivent répondre dans un délai de 5 secondes. Au-delà, la requête est considérée comme échouée.
Retries
En cas d’échec (timeout ou code HTTP non-2xx), CaurisFlux réessaie :
| Tentative | Délai |
|---|
| 1 | Immédiat |
| 2 | 1 minute |
| 3 | 5 minutes |
| 4 | 30 minutes |
| 5 | 2 heures |
Taille du payload
Les webhooks ont une taille maximale de payload. Les métadonnées volumineuses peuvent être tronquées.
Paramètres
| Paramètre | Défaut | Maximum |
|---|
page | 1 | - |
limit | 20 | 100 |
Exemple
Expiration des sessions
Sessions de paiement
Les sessions de paiement (checkout) expirent après un délai configurable.
| Paramètre | Valeur par défaut |
|---|
| Expiration checkout | 15-30 minutes |
expired.
Clés d’idempotence
Les clés d’idempotence sont conservées pendant 24 heures. Après ce délai, la même clé peut créer une nouvelle ressource.
Taille des requêtes
| Limite | Valeur |
|---|
| Taille maximale du body | 1 MB |
| Longueur maximale metadata | Variable |
| Longueur merchant_reference | 255 caractères |
Limites par plan
Les limites varient selon votre plan tarifaire :
| Fonctionnalité | Standard | Business | Enterprise |
|---|
| Rate limit API | Limité | Élevé | Personnalisé |
| Webhooks | Standard | Prioritaires | Dédiés |
| Support | Email | Email + Chat | Dédié |
Ajustement des limites
Si les limites par défaut ne correspondent pas à vos besoins :
- Analysez votre usage dans le Dashboard
- Contactez le support avec vos besoins spécifiques
- Fournissez des justifications (volume prévu, cas d’usage)
Les ajustements sont évalués au cas par cas.
Bonnes pratiques
Optimiser les requêtes
- Évitez les appels inutiles : Cachez les données quand possible
- Utilisez la pagination : Ne récupérez pas toutes les données en une fois
- Groupez les opérations : Utilisez les endpoints de liste plutôt que des appels individuels
Gérer les limites gracieusement
- Implémentez le backoff exponentiel pour les retries
- Surveillez les en-têtes de rate limit
- Alertez quand vous approchez des limites
Préparer la montée en charge
- Testez avec des volumes réalistes en sandbox
- Planifiez les pics d’activité (promotions, événements)
- Contactez le support avant les événements à fort trafic
Support
Pour toute question sur les limites :
