Límites

Rate limit

El rate limit es 120 llamadas por minuto por empresa, compartido entre la API REST y el endpoint MCP. Al superarlo, la API responde 429.

Cómo manejarlo

• El SDK reintenta los 429 automáticamente con backoff exponencial y jitter, respetando el header Retry-After. Si el límite persiste, recibes un RateLimitError con retryAfter:

  import { RateLimitError } from '@simplohq/sdk';
  
  try {
    await simplo.dtes.list();
  } catch (error) {
    if (error instanceof RateLimitError) {
      console.error(`Rate limit. Reintenta en ${error.retryAfter ?? '?'}s`);
    }
  }

• El trabajo por lotes debe marcar su propio ritmo en vez de depender de los reintentos: encola y espacia las llamadas.

• Recuerda que los agentes conectados por MCP consumen el mismo presupuesto que tu backend REST — si corres ambos a la vez, deja margen.

Límites de paginación

limit en los listados va de 1 a 100 items por página (default 20) — ver Paginación.

Relacionado

• Errores — RateLimitError y las reglas de reintento