API rate limiting
Limite journalière
Il existe deux modes de requête API disponibles, chaque mode ayant sa propre limite par défaut de 10.000 requêtes / jour / tenant.
Mode Live (par défaut) : prend en charge les appels en lecture et écriture
Mode Replica : ne prend en charge que les appels en lecture, idéal pour les scénarios de synchronisation (uniquement pour les requêtes OPTIONS, HEAD, GET)
Attention !
Le mode Replica contient une réplique de lecture eventual consistent de la base de données Robaws. Cela le rend dans la plupart des scénarios inutilisable pour des conversations transactionnelles avec notre API.
Il est principalement destiné aux scénarios de synchronisation de masse (comme le remplissage de PowerBI ou d'un datalake).
Vous pouvez changer le mode en replica en passant l'en-tête ou le paramètre de requête "database-mode".
GET https://app.robaws.com/api/v2/offers
Authorization: XXX
Database-Mode: replica
OU
GET https://app.robaws.com/api/v2/offers?database-mode=replica
Authorization: XXX
À l'aide des en-têtes suivants, vous pouvez suivre l'état de la limite :
- X-RateLimit-Daily-Remaining : le nombre de requêtes restantes pour ce jour
- X-RateLimit-Daily-Limit : le nombre total maximum de requêtes par jour (10.000)
- X-RateLimit-Daily-Reset : Le nombre de secondes avant la réinitialisation de la limite.
Si vous atteignez la limite journalière, votre requête échouera avec une erreur 429 Too Many Requests.
La limite journalière est configurable par tenant, de sorte que votre limite réelle peut différer de la valeur par défaut. Si vous avez besoin d'une limite journalière plus élevée, veuillez nous contacter et exposer votre cas.
Requêtes / seconde
En plus de la limite journalière, les requêtes sont également soumises à une limite par seconde qui est appliquée par la passerelle API située devant Robaws (et non par l'application Robaws elle-même).
La limite actuelle est de 15 requêtes / sec.
Vous pouvez utiliser les en-têtes suivants pour suivre l'état de cette limite :
- X-RateLimit-Remaining : le nombre de requêtes restantes pour cette période
Comment gérer les limites de débit
En tant que consommateur de notre API, vous devez rendre votre logiciel client conscient de ces limites de débit. Vous pouvez le faire en consultant les en-têtes de réponse appropriés et en suspendant les appels API jusqu'à la réinitialisation de la limite.
Mis à jour le : 04/07/2026
Merci !
