Skip to main content
Disponible solo en el plan Agencias
La API de Macaly usa claves API para la autenticación. Las claves API pertenecen a un equipo y comparten el mismo sistema de créditos que la interfaz web.

Obtener una clave API

  1. Inicia sesión en tu cuenta de Macaly
  2. Haz clic en tu perfil (arriba a la derecha)
  3. Ve a Ajustes → Claves API
  4. Haz clic en “Crear nueva clave API”
  5. Copia la clave inmediatamente (solo se mostrará una vez)

Usar la clave API

Incluye la clave API en el encabezado Authorization en todas las solicitudes:

Solicitud de ejemplo

Formato de la clave API

Buenas prácticas de seguridad

Las claves API dan acceso completo a los recursos y créditos de tu equipo. Trátalas como contraseñas.
  1. Guarda las claves de forma segura - Usa variables de entorno, nunca las incluyas en el código
  2. Renueva las claves regularmente - Revoca y vuelve a crear las claves periódicamente
  3. Usa claves separadas - Crea claves distintas para diferentes entornos o aplicaciones
  4. Controla el uso - Comprueba tu saldo regularmente desde el panel
  5. Revoca las claves comprometidas - Si una clave queda expuesta, revócala de inmediato

Límites de solicitudes

  • Los intentos fallidos con la clave API están limitados a 5 por minuto por dirección IP
  • Esto protege frente a ataques de fuerza bruta

Gestión de claves

Puedes gestionar tus claves API desde el panel de Macaly:
  • Ver claves - Consulta todas las claves activas con su fecha de creación y último uso
  • Crear claves - Genera claves nuevas con un nombre opcional para identificarlas
  • Revocar claves - Desactiva las claves que ya no necesites o que estén comprometidas