Cuotas por organización
Los límites de tasa se aplican por organización, no por clave. Todas las claves emitidas a la misma organización comparten una cuota, y las llamadas hechas a través del servidor MCP consumen esa misma cuota, así que agregar claves o clientes no multiplica tu límite.
La ventana es deslizante: una solicitud hecha hace 24 horas libera su lugar.
La cuota en los encabezados de respuesta
El estado del límite de tasa viene como encabezados HTTP en cada respuesta (no en el cuerpo):Cuando superas el límite
Las solicitudes por encima de la cuota devuelven429 con un sobre
rate_limit_error y un encabezado Retry-After (segundos):
Retry-After (o X-RateLimit-Reset) y reintenta. Por
MCP, la llamada a la herramienta devuelve un mensaje de error en lugar de un
resultado.
El limitador falla abierto: si el backend de límites no está disponible
por un momento, las solicitudes pasan y no se emiten encabezados
X-RateLimit-*. No dependas de que los encabezados estén siempre presentes.Cómo mantenerte lejos del límite
- Usa
page_size=100al paginar; menos páginas y más grandes cuestan menos solicitudes. - Para una copia completa de los datos, una exportación reemplaza cientos de llamadas a las listas.
- Para agregados, llama una vez a
GET /v1/analyticsen lugar de paginar filas para contarlas. - Sincroniza de forma incremental con
sinceen el feed de actuaciones (consulta Paginación y filtros) en lugar de releer el portafolio.
Siguiente: Errores
El sobre de error y todos los códigos de error.