Limites appliquées pour vous
Fóir plafonne la fréquence à laquelle une clé peut appeler l'API et la taille d'une requête, et vérifie les deux avant l'exécution de la requête. Les limites sont documentées et indiquées dans les en-têtes de réponse.
Taux de requêtes
Chaque clé API a un quota horaire de requêtes fixé par votre forfait. Le quota appartient à cette seule clé et se mesure sur 60 minutes glissantes. L'unité est une requête HTTP, quel que soit le nombre d'enregistrements qu'elle renvoie, et un document qui sélectionne plus de 5 000 champs est facturé en proportion. Chaque réponse indique dans ses en-têtes la limite, ce qui reste et quand elle se réinitialise.
Au-delà de la limite
Une requête refusée reçoit un HTTP 429 avec le code RATE_LIMITED et son en-tête Retry-After associé. Le SDK typé respecte cet en-tête quand il relance.
Une lecture sur l'endpoint GraphQL qui dépasse la limite est servie depuis le cache de réponses quand une réponse en cache existe pour cette requête exacte. Elle revient en HTTP 200 avec l'en-tête X-Foir-Stale: true. Une lecture sans rien en cache reçoit le 429.
Taille des requêtes
Trois plafonds sont appliqués au document analysé avant son exécution : une profondeur maximale de 24, une complexité maximale de 10 000 champs sélectionnés et un maximum de 1 000 alias. La complexité est un simple décompte. Chaque champ sélectionné compte pour un, sans pondération par champ ni multiplication pour les listes, et une union est facturée pour son plus grand membre. Les trois plafonds sont aussi annoncés dans les en-têtes de réponse.
Requêtes simultanées
Un espace de travail peut avoir quelques dizaines de requêtes en cours en même temps. Une de plus est refusée immédiatement avec le même code de limite de taux, sans être mise en file.
Lire le détail
La référence des erreurs donne la limite de taux de chaque forfait, les en-têtes de réponse et les limites de requête.