Für Sie angewendete Limits
Fóir begrenzt, wie oft ein Schlüssel die API aufrufen kann und wie groß eine einzelne Abfrage sein darf, und prüft beides, bevor die Abfrage läuft. Die Limits sind dokumentiert und werden in Antwort-Headern gemeldet.
Anfragerate
Jeder API-Schlüssel hat ein stündliches Anfragekontingent gemäß Ihrem Tarif. Das Kontingent gehört allein diesem Schlüssel und wird über gleitende 60 Minuten gemessen. Die Einheit ist eine HTTP-Anfrage, unabhängig davon, wie viele Datensätze sie zurückgibt, und ein Dokument, das mehr als 5.000 Felder auswählt, wird anteilig berechnet. Jede Antwort meldet in ihren Headern das Limit, was übrig ist und wann es zurückgesetzt wird.
Über dem Limit
Eine abgewiesene Anfrage erhält HTTP 429 mit dem Code RATE_LIMITED und einem Retry-After Header. Das typisierte SDK beachtet den Header bei Wiederholungen.
Ein Lesezugriff auf den GraphQL-Endpunkt, der über dem Limit liegt, wird aus dem Antwort-Cache beantwortet, wenn für genau diese Anfrage eine gecachte Antwort existiert. Sie kommt mit HTTP 200 und dem Header X-Foir-Stale: true. Ein Lesezugriff ohne gecachte Antwort erhält die 429.
Abfragegröße
Drei Obergrenzen werden auf das geparste Dokument angewendet, bevor es ausgeführt wird: eine maximale Tiefe von 24, eine maximale Komplexität von 10.000 ausgewählten Feldern und maximal 1.000 Aliasse. Die Komplexität ist eine einfache Zählung. Jedes ausgewählte Feld zählt als eins, ohne Gewichte pro Feld und ohne Multiplikation für Listen, und eine Union wird mit ihrem größten Mitglied berechnet. Die drei Obergrenzen werden auch in Antwort-Headern ausgewiesen.
Gleichzeitige Anfragen
Ein Workspace kann einige Dutzend Anfragen gleichzeitig laufen haben. Eine weitere darüber hinaus wird sofort mit demselben Rate-Limit-Code abgewiesen, ohne in eine Warteschlange zu kommen.
Details nachlesen
Die Fehlerreferenz nennt das Rate-Limit für jeden Tarif, die Antwort-Header und die Abfragelimits.