Gestionar claves de API
Crea, gestiona y revoca claves de API para integraciones externas. Úsalas para autenticarte en la API REST de Bugalou.
Visión general
Las claves de API te permiten integrar Bugalou con sistemas externos y aplicaciones personalizadas. Se usan para autenticar las solicitudes a todas las API REST de Bugalou, ya sea para enviar plantillas de WhatsApp, gestionar pedidos o consultar facturas. Ve a Configuración de la organización → API e integraciones.
Crear una clave de API
- Haz clic en "Crear API key" en la esquina superior derecha
- Introduce un Nombre para la clave (p. ej. "API de producción", "Entorno de pruebas")
- Haz clic en "Crear clave"
- La clave completa se muestra una sola vez en una tarjeta verde: ¡cópiala ahora! Haz clic en "Copiar" y después en "He guardado mi clave"
Importante: la clave completa solo se muestra una vez. Después de confirmar, solo es visible el prefijo (bg_live_••••••••).
Gestionar las claves
Cada tarjeta de clave de API muestra:
- Nombre — el nombre que elegiste para la clave
- Insignia de estado — "Activa" (verde) o "Desactivada" (gris)
- Prefijo — clave enmascarada:
bg_live_•••••••• - Creada — fecha de creación
- Último uso — cuándo se usó la clave por última vez en una llamada a la API
Acciones de las claves
- Desactivar / Activar — desactiva una clave temporalmente sin eliminarla
- Revocar — elimina la clave de forma permanente (con cuadro de diálogo de confirmación)
Autenticación
Incluye tu clave de API en cada solicitud con uno de estos dos métodos:
X-API-Key: bg_live_your_key_here— encabezado personalizadoAuthorization: Bearer bg_live_your_key_here— token Bearer
Ambos métodos funcionan en todos los endpoints de la API.
Buenas prácticas de seguridad
- No compartas nunca tu clave de API en repositorios de código públicos
- Usa variables de entorno para almacenar las claves en tus aplicaciones
- Crea claves distintas para los entornos de producción y de pruebas
- Desactiva o revoca las claves que ya no necesites
- Rota las claves periódicamente: crea una clave nueva, actualiza tus integraciones y después revoca la antigua
API disponibles
Una vez que tengas una clave de API, puedes usar las siguientes API REST:
- API de plantillas de WhatsApp — envía mensajes de plantilla de forma programática
- API de pedidos y comercio electrónico — gestiona pedidos de tiendas online y sistemas personalizados
- API de facturación y pagos — consulta facturas, pagos y datos financieros