Límites de solicitudes
Límites por plan
Cada espacio de trabajo tiene un presupuesto por minuto y una ventana de ráfaga: como máximo 2× la tasa media en cualquier intervalo de 10 segundos. El que se agote primero responde 429 rate_limited con Retry-After. Tu propio uso de la app nunca cuenta contra el presupuesto de la API.
| Plan | Por minuto | Ráfaga | Incluidos / mes | Tareas simultáneas |
|---|---|---|---|---|
| Pro | 60 | 20 / 10 s | 4000 | 2 |
| Business | 600 | 200 / 10 s | 12.000 | 5 |
| Enterprise | a medida | a medida | a medida | a medida |
Cabeceras de respuesta
X-RateLimit-LimitSolicitudes permitidas por minuto para el espacio de trabajo.X-RateLimit-RemainingSolicitudes que quedan en el minuto actual.X-RateLimit-ResetSegundos hasta que se reinicia la ventana del minuto (no es una hora Unix).Retry-AfterEn cada 429: segundos que hay que esperar antes de reintentar.X-Request-IdEl id de la solicitud, también en los cuerpos de error. Indícalo al contactar con soporte.Idempotent-Replayedtrue cuando la respuesta es una repetición de una solicitud anterior.Solicitudes mensuales
Cada plan incluye un número de solicitudes por mes natural (UTC). El uso se muestra en Settings → API junto a la latencia y la tasa de errores de los últimos 30 días. Superarlo hoy no se rechaza; anunciaremos cualquier cambio aquí y en el registro de cambios antes de aplicarlo.
Trabajo pesado
Las tandas en lote y las exportaciones en ZIP se ejecutan en segundo plano y comparten las tareas simultáneas del plan; las demás esperan en una cola. Síguelas consultando su estado o con los webhooks bulk.completed y export.completed, en lugar de consultar en un bucle cerrado.