Límites aplicados por ti
Fóir limita la frecuencia con que una clave puede llamar a la API y el tamaño que puede tener una sola consulta, y comprueba ambos antes de ejecutarla. Los límites están documentados y se informan en las cabeceras de respuesta.
Tasa de solicitudes
Cada clave de API tiene una cuota horaria de solicitudes fijada por tu plan. La cuota pertenece solo a esa clave y se mide en una ventana deslizante de 60 minutos. La unidad es una solicitud HTTP, por muchos registros que devuelva, y un documento que selecciona más de 5,000 campos se cobra en proporción. Cada respuesta informa en sus cabeceras del límite, de lo que queda y de cuándo se restablece.
Por encima del límite
Una solicitud rechazada recibe HTTP 429 con el código RATE_LIMITED y una cabecera Retry-After en la respuesta. El SDK tipado respeta la cabecera cuando reintenta.
Una lectura en el endpoint GraphQL que supera el límite se responde desde la caché de respuestas cuando existe una respuesta en caché para esa misma solicitud. Vuelve como HTTP 200 con la cabecera X-Foir-Stale: true. Una lectura sin nada en caché recibe el 429.
Tamaño de la consulta
Se aplican tres topes sobre el documento analizado antes de que se ejecute: una profundidad máxima de 24, una complejidad máxima de 10,000 campos seleccionados y un máximo de 1,000 alias. La complejidad es un simple recuento. Cada campo seleccionado cuenta como uno, sin pesos por campo y sin multiplicación por listas, y una unión se cobra por su miembro más grande. Los tres topes también se anuncian en las cabeceras de respuesta.
Solicitudes simultáneas
Un espacio de trabajo puede tener unas pocas decenas de solicitudes en ejecución a la vez. Una más que eso se rechaza de inmediato con el mismo código de límite de tasa, sin ponerse en cola.
Lee el detalle
La referencia de errores da el límite de tasa de cada plan, las cabeceras de respuesta y los límites de consulta.