Limites d'usage

Les limites existent pour qu’une boucle emballée chez un intégrateur ne dégrade pas le service des autres. Elles sont dimensionnées pour qu’une entreprise normale ne les rencontre jamais.

Ce qui est inclus

Limite	Valeur
Requêtes par mois civil	25 000
Requêtes par minute (rafale)	60

La limite par minute attrape l’emballement — une boucle sans condition d’arrêt, un retry mal écrit. La limite mensuelle est celle qui correspond à votre usage réel.

Les deux limites s’appliquent par entreprise et par mode. Le mode test est compté séparément : il a son propre quota, de même taille, et n’entame jamais votre quota live. Essayer ne coûte rien.

Ce qui se passe quand vous approchez de la limite

Nous ne coupons pas le service à 100 %. Une coupure nette transformerait une conversation commerciale en panne de production, et elle frapperait justement les entreprises dont l’activité grandit.

À la place :

Vous êtes prévenu à 50 %, 80 % et 100 % de votre quota mensuel.
Passé 100 %, un dépassement de 20 % est toléré — une seule fois par mois civil. Vos appels continuent de passer.
Ce dépassement épuisé, les appels sont refusés jusqu’au mois suivant.

La tolérance ne se reconduit pas à l’intérieur du même mois : elle sert à vous laisser le temps de nous appeler, pas à vous installer durablement au-dessus de votre limite.

Quand une limite est atteinte

La réponse est un 429, accompagnée des en-têtes qui disent quoi faire :

HTTP/1.1 429 Too Many Requests
Retry-After: 30
Tay-RateLimit-Limit: 60
Tay-RateLimit-Remaining: 0
Tay-RateLimit-Reset: 1758186794

Deux codes, parce que les deux échecs appellent des réactions différentes. rate_limited signifie ralentissez et réessayez ; quota_exceeded signifie que le mois est consommé et que réessayer ne servira à rien avant la remise à zéro.

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests: the limit is 60 per minute. Retry after 30s, and see https://tayo.pro/contact if you need a higher limit."
  }
}

{
  "error": {
    "code": "quota_exceeded",
    "message": "The monthly quota of 25000 requests, and the overage allowance on top of it, are spent. It resets on 2026-10-01. See https://tayo.pro/contact to agree a higher limit."
  }
}

Les deux portent un en-tête Link: <…>; rel="help" qui pointe vers la page pour demander une limite plus élevée. Il n’y a pas d’augmentation en libre-service — voir plus bas.

Respectez Retry-After plutôt que de réessayer immédiatement. Un client qui réessaie en boucle sur un 429 ne fait que consommer sa propre tolérance.

Connaître sa consommation

curl https://app.tayo.pro/api/v1/usage \
  -H "Authorization: Bearer tay_live_votre_cle"

{
  "mode": "live",
  "period": "2026-09",
  "resetAt": "2026-10-01T00:00:00.000Z",
  "limits": { "monthlyRequests": 25000, "burstPerMinute": 60, "source": "default" },
  "month": { "used": 12483, "remaining": 12517, "state": "within" }
}

state vaut within sous le quota, overage dans la tolérance unique, et exhausted une fois les appels refusés. source indique override lorsque votre entreprise dispose d’une limite négociée plutôt que de la valeur publiée.

Vous obtenez le mode de la clé présentée : une clé tay_test_… rapporte la consommation de test, jamais les chiffres de production.

Cet endpoint ne compte pas dans le quota mensuel et n’est jamais refusé par lui : c’est le seul appel qui répond encore une fois le quota consommé. Il reste soumis à la limite par minute.

Les compteurs sont tenus par mois civil, en UTC.

La consommation, ainsi que vos requêtes échouées des 30 derniers jours, est aussi visible dans Paramètres → API.

Il vous faut plus

Contactez-nous, depuis Aide → Contacter l’équipe ou sur tayo.pro/contact. La limite se relève par entreprise, sans que vous ayez à changer quoi que ce soit dans votre code, et nous convenons ensemble d’un prix adapté à votre volume.

Il n’y a pas de grille de paliers à choisir : les usages intensifs sont trop différents les uns des autres pour qu’une grille leur rende justice.

Cette conversation est commerciale, pas de l’assistance : elle n’est jamais facturée — voir Assistance API.