Limiti applicati per te
Fóir limita la frequenza con cui una chiave può chiamare l'API e la dimensione di una singola query, e controlla entrambe prima che la query venga eseguita. I limiti sono documentati e riportati negli header della risposta.
Frequenza delle richieste
Ogni chiave API ha un limite orario di richieste stabilito dal tuo piano. Il limite appartiene solo a quella chiave ed è misurato su 60 minuti scorrevoli. L'unità è una richiesta HTTP, indipendentemente da quanti record restituisce, e un documento che seleziona più di 5.000 campi viene addebitato in proporzione. Ogni risposta riporta nei suoi header il limite, quanto resta e quando si azzera.
Oltre il limite
Una richiesta rifiutata riceve HTTP 429 con il codice RATE_LIMITED e un header Retry-After che l'SDK tipizzato rispetta quando ritenta.
Una lettura sull'endpoint GraphQL che supera il limite riceve risposta dalla cache delle risposte quando esiste una risposta in cache per quella stessa richiesta. Torna come HTTP 200 con l'header X-Foir-Stale: true. Una lettura senza nulla in cache riceve il 429.
Dimensione della query
Tre limiti vengono applicati al documento già analizzato prima che venga eseguito: una profondità massima di 24, una complessità massima di 10.000 campi selezionati e un massimo di 1.000 alias. La complessità è un semplice conteggio. Ogni campo selezionato conta uno, senza pesi per campo e senza moltiplicazione per le liste, e una union viene addebitata per il suo membro più grande. Anche i tre limiti sono riportati negli header della risposta.
Richieste concorrenti
Un workspace può avere alcune decine di richieste in esecuzione contemporaneamente. Una in più viene rifiutata subito con lo stesso codice di rate limit, senza essere messa in coda.
Leggi i dettagli
Il riferimento sugli errori indica il rate limit per ogni piano, gli header della risposta e i limiti delle query.