Cómo funcionan los límites de uso
Por qué la API responde “demasiadas peticiones” cuando una clave envía demasiadas en un minuto, y qué hacer.
Cada clave de API puede hacer un número limitado de peticiones por minuto. El límite protege tu cuenta: un script que falla no puede ralentizar Filmo para tu equipo ni para las demás herramientas que usan la API.
Cuáles son los límites
| Qué | Límite | A quién se aplica |
|---|---|---|
| Cualquier petición | 120 por minuto | A cada clave de API, entre todo lo que hace |
| Consultas de disponibilidad | 30 por minuto | A cada clave de API, para artículos, personal y vehículos juntos |
Las consultas de disponibilidad tienen un límite propio y más bajo porque son las preguntas más pesadas que responde Filmo, y además cuentan dentro del límite general. Los límites son los mismos en todos los planes.
Un asistente de IA conectado a Filmo está sujeto a los mismos límites: cada cosa que consulta o cambia es una petición de la conexión con la que trabaja.
Qué pasa cuando una clave se pasa
Filmo no rompe nada ni pierde datos. Responde a las peticiones de más con “demasiadas peticiones” y los segundos que hay que esperar. Cuando acaba el minuto, la clave vuelve a funcionar.
Si una integración o un asistente dice “demasiadas peticiones”
- Espera un minuto. El límite cuenta por minuto, así que casi siempre basta con eso.
- Comprueba qué está usando la clave. Abre «API y MCP» en Configuración, luego «Claves de API», y mira el nombre de la clave y cuándo se usó por última vez. Una clave compartida por varias herramientas suma todas sus peticiones.
- Da a cada herramienta su propia clave. Así una herramienta muy activa no gasta las peticiones de otra. Consulta Genera una clave de API.
- Pide a quien construyó la integración que espacie sus peticiones. Una integración bien hecha espera el tiempo que Filmo le pide y pide solo lo que cambió, en lugar de leerlo todo una y otra vez.
Traer muchos datos de golpe
Una importación puntual de miles de registros puede llegar al límite sin remedio. Repártela en el tiempo, o pide a quien la hace que siga la guía para desarrolladores de abajo.
Para quien construye la integración
Cada respuesta dice a la integración cuántas peticiones le quedan, y una rechazada indica cuánto esperar. Los detalles, con ejemplos de reintento, están en la guía de límites de uso, y los límites que importan a los asistentes de IA en la guía de límites de MCP.
Recursos relacionados
- Elige qué puede hacer una clave: Permisos de la API (scopes).
- Mantén otro sistema al día: Reaccionar a cambios sin webhooks.
Preguntas frecuentes
Los límites son los mismos para todas las cuentas. Si tu integración necesita más, contacta con soporte y cuéntanos qué hace.
No. Se aplican a las claves de API, y a los asistentes de IA conectados con ellas, no a las personas que trabajan en la aplicación.