Chaque requête vers api.ferrlens.com est comptée par adresse IP de l'appelant. Il n'y a pas encore de quota par compte : se connecter ne change pas la limite.

Le bucket

Chaque IP a un token bucket. Une requête coûte un jeton.

Réglage	Valeur par défaut
Burst (taille du bucket)	30 requêtes
Recharge	0,5 jeton par seconde (30 par minute)

Une nouvelle IP démarre avec un bucket plein : une rafale de 30 requêtes passe immédiatement. Ensuite, vous êtes limité au rythme de recharge. GET /health n'est pas compté.

En-têtes de réponse

Chaque réponse comptée porte :

En-tête	Signification
x-ratelimit-limit	Taille du bucket
x-ratelimit-remaining	Jetons restants après cette requête

Quand vous êtes limité

L'API répond 429 Too Many Requests avec un en-tête Retry-After (secondes entières avant qu'un jeton soit disponible, 1 au minimum) et un corps JSON :

{
  "code": "RATE_LIMITED",
  "message": "too many requests - slow down and retry",
  "retry_after_secs": 2
}

Attendez Retry-After secondes puis réessayez. x-ratelimit-remaining vaut 0 sur une réponse limitée.

À savoir

• Certains endpoints font plus de travail que d'autres par requête. Une vérification de liens coûte aussi un seul jeton, mais peut durer jusqu'à 60 secondes.
• Les IP derrière un même NAT partagent un bucket.