Generar una Clave API
Las claves API permiten que sistemas externos se autentiquen contra la API REST de Dinaup para leer y escribir datos programáticamente.
Requisitos previos
- Ser administrador
- Tener la solución Desarrollo activada
Acceso
dinaup.com > Claves API
Pasos
1. Crear nueva clave
Ve a Claves API en el menú lateral y haz clic en Nueva Clave.
2. Configurar la clave
| Campo | Descripción |
|---|---|
| Nombre | Identificador descriptivo (ej: "n8n producción", "Web corporativa") |
| Usuario asociado | La clave hereda los permisos de este usuario |
Seguridad
La clave tiene los mismos permisos que el usuario asociado. Si el usuario puede leer y escribir en Pymes, la clave también puede. Crea un usuario específico con permisos mínimos para cada integración.
3. Guardar y copiar
Al guardar, Dinaup genera la clave. Cópiala inmediatamente — no se puede recuperar después.
La clave tiene el formato:
servidor_hash1hash2
4. Usar en la API
Incluye la clave en el header Authorization de cada petición:
curl -X GET "https://webhook.dinaup.com/api/whoami" \
-H "Authorization: Bearer tu-clave-api-aqui"
Si la respuesta es 200 OK con datos del usuario, la clave funciona correctamente.
Buenas prácticas
- Nunca incluyas claves API en código frontend o repositorios públicos
- Crea una clave por integración (no reutilices)
- Asigna permisos mínimos al usuario de cada clave
- Rota las claves periódicamente