¿Cuáles son los límites de tasa?

Actualmente, no imponemos límites estrictos de peticiones por segundo. Sin embargo, se espera un uso justo para mantener la calidad del servicio para todos.

Enfoque actual

En lugar de límites duros, fomentamos el uso responsable:

• Espacía tus peticiones razonablemente

• Implementa retroceso exponencial cuando ocurran errores

• Cachea respuestas para evitar llamadas redundantes

• Contáctanos si anticipas volúmenes de tráfico altos

Mejores prácticas

Cachea agresivamente:

• Almacena resultados de búsqueda para consultas comunes

• Guarda metadatos de medios localmente después de recuperarlos

• No llames a /confirm múltiples veces para el mismo usuario/recurso

Agrupa tus operaciones:

• Agrupa peticiones relacionadas

• Añade pequeños retrasos entre lotes

• Limita conexiones concurrentes (10-20 es razonable)

Maneja errores con elegancia:

• Implementa lógica de reintento con retroceso exponencial

• No reintentes inmediatamente al fallar

• Registra errores para monitoreo

Tiempos de respuesta esperados

• Búsqueda /resources: 200-500ms típicamente

• Detalles /resource: Menos de 100ms

• Licenciamiento /confirm: 300-800ms

Configura el timeout de tu cliente a al menos 30 segundos para manejar respuestas ocasionalmente más lentas.

Si alcanzas límites

Recibirás un error 429 Too Many Requests. Cuando esto suceda:

// Implementa retroceso exponencial
async function fetchWithRetry(url, options, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      const response = await fetch(url, options);
      
      if (response.status === 429) {
        const waitTime = Math.pow(2, i) * 1000; // 1s, 2s, 4s
        await new Promise(resolve => setTimeout(resolve, waitTime));
        continue;
      }
      
      return response;
    } catch (error) {
      if (i === maxRetries - 1) throw error;
    }
  }
}

Monitorea tu uso

Rastrea la actividad de la API en Ajustes → API:

• Ver total de peticiones realizadas

• Comprobar licencias activas

• Revisar tendencias de uso

• Monitorear patrones inusuales

¿Necesitas límites más altos?

Si tu caso de uso legítimo requiere altos volúmenes de peticiones (>1M peticiones/mes), contacta con nuestro equipo para discutir:

• Tu aplicación y patrones de tráfico

• Volumen de peticiones esperado

• Límites de tasa garantizados si se necesitan