🔐 ¿Qué es una API Key?
Una API Key es una clave secreta que identifica tu cuenta y permite acceder a la API.
Ejemplo:
cmnk_live_XXXXXXXXXXXXXXXX
⚙️ Cómo crear una API Key
Puedes generar una API Key desde el panel de Caminna:
Settings → Integraciones → API Keys
Al crearla podrás:
Asignar permisos específicos (read, write)
Limitar el acceso por recursos (leads, contacts, etc.)
⚠️ Importante: guarda la clave en un lugar seguro. No podrás verla de nuevo.
📡 Cómo usar la API Key
Debes incluir la API Key en el header Authorization de cada petición:
Authorization: Bearer TU_API_KEY
💻 Ejemplo de petición
curl -X GET https://api.caminna.com/v1/leads \ -H "Authorization: Bearer TU_API_KEY"
🔒 Permisos de la API Key
Cada API Key tiene permisos definidos.
Ejemplos:
read
write
read
write
Si una petición falla por permisos, recibirás un error 403.
❗ Errores comunes
401 Unauthorized
La API Key es inválida o no se ha enviado correctamente.
Revisa:
Que el header Authorization esté presente
Que uses el formato correcto: Bearer TU_API_KEY
403 Forbidden
No tienes permisos suficientes para realizar la acción.
Solución:
Revisa los permisos asignados a la API Key
429 Too Many Requests
Has superado el límite de uso de la API.
🛡️ Buenas prácticas
No compartas tu API Key públicamente
No la incluyas en código frontend
Usa variables de entorno en tu backend
Genera diferentes claves para cada integración
🚀 Siguiente paso
Una vez autenticado correctamente, puedes hacer tu primera petición:
👉 Crear un lead
🤝 Soporte
Si tienes problemas con la autenticación, contacta con soporte desde el chat.