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
- Entra a Usuarios → Usuarios y pulsa Nuevo.
- Elige el tipo API, escribe un nombre de usuario (por ejemplo, tienda-en-linea) y selecciona el rol del paso anterior.
- Pulsa Guardar.
- 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
- En Usuarios → Usuarios, abre la clave (lápiz).
- 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.
- 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
La API responde 429
La clave superó su límite por minuto. Espera el tiempo que indica el encabezado Retry-After o sube el límite.
La API responde 403 “La clave de API venció”
Cambia la fecha de vencimiento o crea una clave nueva.
403 “Esta clave no puede usarse desde la dirección…”
Agrega la IP de tu servidor a la lista o vacía la lista. Si tu servidor cambia de IP seguido, no uses esta opción.
Perdí la clave
No se puede recuperar. Crea otra y desactiva la anterior.
Muchos errores en el uso
Revisa que la clave tenga los permisos necesarios y que la otra herramienta envíe datos válidos.
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).
Spanish 
English