Crear y proteger una clave de API

Qué vas a lograr

Crear una clave para que otra herramienta (tu sitio web, tu CRM, tu automatización) se conecte a tu cuenta de Archie Send, y protegerla con una fecha de vencimiento, un límite de peticiones y las direcciones IP desde las que puede usarse.

Antes de empezar

• Entra con un usuario que pueda gestionar usuarios (por ejemplo, Administrador).
• Decide qué necesita hacer la otra herramienta (solo leer contactos, agregar contactos, enviar correos transaccionales…). Crea antes un rol con solo esos permisos en Usuarios → Roles de usuario: una clave solo puede hacer lo que su rol permite.

Paso 1: crear la clave

1. Entra a Usuarios → Usuarios y pulsa Nuevo.
2. Elige el tipo API, escribe un nombre de usuario (por ejemplo, tienda-en-linea) y selecciona el rol del paso anterior.
3. Pulsa Guardar.
4. Copia la clave que aparece. Solo se muestra una vez: guárdala en tu gestor de contraseñas. Si la pierdes, crea otra clave.

Captura: ventana con la clave de API mostrada una sola vez

Paso 2: poner límites a la clave

1. En Usuarios → Usuarios, abre la clave (lápiz).
2. En Límites de esta clave define:

• Peticiones por minuto: entre 10 y 1.200. Por defecto son 120.
• Vence el: una fecha. La clave deja de funcionar al final de ese día (hora de Colombia). Vacío = no vence.
• Direcciones IP permitidas: una por línea (también rangos como 10.0.0.0/8). Vacío = desde cualquier dirección.

1. Pulsa Guardar. Los cambios valen de inmediato.

Captura: sección “Límites de esta clave” con uso de los últimos 30 días

Cómo usarla

Envía la clave en cada petición con el encabezado Authorization: token USUARIO:CLAVE, donde USUARIO es el nombre de usuario de la clave.

Resultado esperado

• La lista de usuarios muestra, bajo cada clave, cuándo se usó por última vez y cuándo vence.
• En la clave ves las peticiones y los errores de los últimos 30 días.

Problemas frecuentes

Cuándo contactar a soporte

Si crees que alguien usó tu clave sin permiso, desactívala de inmediato y escríbenos con el nombre de usuario de la clave y la hora aproximada (nunca envíes la clave).