Limitation de débit (Rate Limiting)

La Fleet API Cartrack applique des limitations de débit à toutes les requêtes entrantes afin de protéger les ressources réseau, maintenir les performances et garantir une expérience cohérente pour tous les utilisateurs.

Limite par défaut

La limite par défaut est de 1 000 requêtes par minute. Cette valeur s'applique sur la plupart des endpoints, sauf mention contraire. Les requêtes dépassant cette limite recevront une réponse HTTP 429 Too Many Requests.

Limites spécifiques par endpoint

Certains endpoints disposent de limites plus strictes pour garantir l'équité et prévenir les abus. Voici les limites applicables :

Endpoint	Limite	Description
POST /fuel/consumed	10 requêtes / minute	Estimation de carburant consommé pour plusieurs véhicules.
POST /fuel/level	10 requêtes / minute	Récupération des données de capteur de carburant pour plusieurs véhicules.
POST /vehicles/ev-consumption	10 requêtes / minute	Consommation de batterie estimée pour plusieurs véhicules électriques.
POST /vehicles/range	10 requêtes / minute	Récupération des événements d'autonomie pour plusieurs véhicules électriques.
POST /vehicles/soc	10 requêtes / minute	Récupération des événements d'état de charge (SoC) pour plusieurs véhicules.
GET /vehicles/vext	10 requêtes / minute	Récupération des données VEXT des véhicules, indépendamment de l'état du contact.

Le dépassement d'une limite spécifique renverra également un HTTP 429 Too Many Requests.

Comportement de retry

Si vous recevez un HTTP 429 Too Many Requests, respectez les en‑têtes inclus dans la réponse. Ils indiquent quand vous pouvez réessayer :

• X-RateLimit-Retry-At : timestamp du prochain essai autorisé.
• X-RateLimit-Retry-After-Seconds : nombre de secondes avant le prochain essai possible.

Exemple de réponse

HTTP/1.1 429 Too Many Requests
Content-Type: application/json
X-RateLimit-Retry-At: 1737592000
X-RateLimit-Retry-After-Seconds: 15

{
    "error": {
        "code": 429,
        "message": "Too many requests. Please wait before retrying."
    }
}

Comment gérer un 429 Too Many Requests

• Attendre et réessayer : respectez X-RateLimit-Retry-At et X-RateLimit-Retry-After-Seconds avant de relancer la requête.
• Repli exponentiel : implémentez un backoff exponentiel avec jitter pour éviter des collisions répétées.

Remarque : des violations répétées peuvent entraîner des restrictions d'accès temporaires ou permanentes.

Augmentation des limites

Si votre application nécessite un débit supérieur, soumettez une demande d'augmentation de quota. Chaque demande est étudiée au cas par cas pour garantir la compatibilité avec notre infrastructure. Les limites approuvées seront communiquées et adaptées à votre cas.