rate_limited

Statut HTTP : 429 · Rejouable : oui, après un délai d'attente.

Cause

Vous avez dépassé le quota de requêtes. Deux fenêtres s'appliquent simultanément :

Fenêtre	Limite
1 seconde	10 requêtes
60 secondes	100 requêtes

Un pic court déclenche donc un 429 même si la moyenne sur la minute reste sous la limite.

Réponse

HTTP/1.1 429 Too Many Requests
Content-Type: application/problem+json

{
  "type": "https://docs.pesia.fr/partner/errors/rate_limited",
  "title": "Rate Limited",
  "status": 429,
  "detail": "ThrottlerException: Too Many Requests",
  "code": "rate_limited",
  "instance": "/partner/v1/smic",
  "timestamp": "2026-08-14T09:12:44.318Z"
}

Extensions

Aucune — seuls les champs standard ci-dessus.

Que faire

• Réessayer après un délai, avec un backoff exponentiel et un jitter. Rejouer immédiatement prolonge le blocage.
• Lisser les traitements en lot : envoyer 500 requêtes en rafale est garanti de déclencher la fenêtre à la seconde.
• Utiliser les endpoints de collection plutôt que N appels unitaires quand l'opération le permet — un dépôt DPAE ou un lot de paie accepte plusieurs éléments en une requête.
• Un rejeu après 429 doit réutiliser la même clé Idempotency-Key que l'envoi bloqué : la requête n'a pas été traitée, l'intention est inchangée.

Voir aussi : Idempotence · Tous les codes d'erreur