Quotas et limites

Chaque réponse authentifiée expose les limites de son accès :

X-RateLimit-Limit
X-RateLimit-Remaining
X-RateLimit-Reset
X-Orbit-Daily-RateLimit-Limit
X-Orbit-Daily-RateLimit-Remaining
X-Orbit-Daily-RateLimit-Reset

Les valeurs Reset sont des timestamps Unix en secondes. Les quotas sont partagés entre toutes les clés d’un même accès.

Dans la Preview commerciale, les accès libre-service exposent aussi leur offre et le compteur commercial :

X-Orbit-Plan
X-Orbit-Monthly-Usage-Included
X-Orbit-Monthly-Usage-Used
X-Orbit-Monthly-Usage-Limit
X-Orbit-Monthly-Usage-Remaining
X-Orbit-Monthly-Usage-Reset

Ces en-têtes sont absents des accès historiques ou complémentaires qui ne sont pas soumis au comptage commercial. Included désigne le volume inclus et Limit le plafond dur. Ils ont tous les deux la valeur 10000 sur l’offre Gratuite et 50000 sur l’offre Pro : aucun dépassement payant n’est accepté.

Consommation actuelle

L’authentification consomme les quotas minute et jour avant la validation de la route ou du corps. Une requête dont la clé est valide peut donc consommer ces protections même si elle se termine ensuite en erreur applicative.

Les clés absentes, invalides, expirées, révoquées, les accès suspendus et les permissions insuffisantes ne consomment pas ces quotas.

Le compteur mensuel est séparé. Orbit réserve une place après authentification, puis comptabilise le résultat métier lorsqu’il est compris entre 200 et 299. Dans le fonctionnement normal, une erreur 4xx ou 5xx libère la réservation et n’entame pas le volume mensuel. Une requête en cours apparaît temporairement dans le nombre réservé du portail.

Une coupure réseau exactement au moment de la confirmation peut rendre le statut reçu par le client différent du résultat déjà enregistré. Orbit conserve alors la réservation comme preuve afin de pouvoir rapprocher l’usage et, avant toute facturation réelle, appliquer le crédit correctif prévu par la politique commerciale.

Dépassement

Un dépassement minute ou jour renvoie 429 rate_limit_exceeded. Le plafond mensuel renvoie 429 monthly_quota_exceeded. Dans les deux cas, Retry-After indique le délai minimal avant une nouvelle tentative. N’envoyez pas de tentatives parallèles et ne contournez jamais la limite avec plusieurs clés.

Stripe n’est pas appelé pour mesurer chaque requête et ne reçoit aucun événement de dépassement. Dans la Preview, l’abonnement Pro est un prix mensuel fixe et 50 000 constitue à la fois le volume inclus et le plafond.