Limites aplicados para você
O Fóir limita a frequência com que uma chave pode chamar a API e o tamanho de uma única consulta, e verifica os dois antes de a consulta ser executada. Os limites são documentados e informados nos cabeçalhos de resposta.
Taxa de requisições
Cada chave de API tem uma cota horária de requisições definida pelo seu plano. A cota pertence apenas àquela chave e é medida em uma janela deslizante de 60 minutos. A unidade é uma requisição HTTP, não importa quantos registros ela retorne, e um documento que seleciona mais de 5.000 campos é cobrado proporcionalmente. Toda resposta informa nos cabeçalhos o limite, o que resta e quando ele é reiniciado.
Acima do limite
Uma requisição recusada recebe HTTP 429 com o código RATE_LIMITED e Retry-After no cabeçalho. O SDK tipado respeita o cabeçalho ao fazer novas tentativas.
Uma leitura no endpoint GraphQL que passa do limite é respondida a partir do cache de respostas quando existe uma resposta em cache para aquela requisição exata. Ela volta como HTTP 200 com o cabeçalho X-Foir-Stale: true. Uma leitura sem nada em cache recebe o 429.
Tamanho da consulta
Três limites são impostos ao documento já analisado antes de ele ser executado: uma profundidade máxima de 24, uma complexidade máxima de 10.000 campos selecionados e um máximo de 1.000 aliases. A complexidade é uma contagem simples. Cada campo selecionado conta como um, sem pesos por campo e sem multiplicação para listas, e uma union é cobrada pelo seu maior membro. Os três limites também são anunciados nos cabeçalhos de resposta.
Requisições concorrentes
Um workspace pode ter algumas dezenas de requisições em execução ao mesmo tempo. Uma a mais que isso é recusada imediatamente com o mesmo código de limite de taxa, sem entrar em fila.
Leia os detalhes
A referência de erros traz o limite de taxa de cada plano, os cabeçalhos de resposta e os limites de consulta.