Panoramica
Le chiavi API ti permettono di integrare Bugalou con sistemi esterni e applicazioni personalizzate. Servono ad autenticare le richieste a tutte le REST API di Bugalou, che tu stia inviando modelli WhatsApp, gestendo ordini o monitorando fatture. Vai a Impostazioni organizzazione → API e integrazioni. Le chiavi API e la REST API sono disponibili con il piano Enterprise.
Creare una chiave API
- Clicca su “Crea chiave API” in alto a destra
- Inserisci un nome per la chiave (per esempio “API di produzione”, “Ambiente di staging”)
- Clicca su “Crea chiave”
- La chiave completa viene mostrata una sola volta in una scheda verde: copiala subito! Clicca su “Copia” e poi su “Ho salvato la mia chiave”
Importante: la chiave completa viene mostrata una sola volta. Dopo la conferma è visibile solo il prefisso (bg_live_••••••••).
Gestire le chiavi
Ogni scheda di una chiave API mostra:
- Nome — il nome che hai scelto per la chiave
- Badge di stato — “Attiva” (verde) o “Disattivata” (grigio)
- Prefisso — la chiave mascherata:
bg_live_•••••••• - Creata — la data di creazione
- Ultimo utilizzo — quando la chiave è stata usata l'ultima volta per una chiamata API
Azioni sulle chiavi
- Disattiva / Attiva — disattiva temporaneamente una chiave senza eliminarla
- Revoca — elimina definitivamente la chiave (con finestra di conferma)
Autenticazione
Includi la tua chiave API in ogni richiesta con uno di questi due metodi:
X-API-Key: bg_live_your_key_here— header personalizzatoAuthorization: Bearer bg_live_your_key_here— Bearer token
Entrambi i metodi funzionano con tutti gli endpoint dell'API.
Buone pratiche di sicurezza
- Non condividere mai la tua chiave API in repository di codice pubblici
- Usa variabili d'ambiente per salvare le chiavi nelle tue applicazioni
- Crea chiavi separate per gli ambienti di produzione e di staging
- Disattiva o revoca le chiavi che non ti servono più
- Ruota periodicamente le chiavi: crea una nuova chiave, aggiorna le tue integrazioni, poi revoca quella vecchia
API disponibili
Una volta che hai una chiave API, puoi usare queste REST API:
- API dei modelli WhatsApp — invia modelli tramite codice
- API ordini ed e-commerce — gestisci gli ordini da negozi online e sistemi personalizzati
- API fatturazione e pagamenti — monitora fatture, pagamenti e dati finanziari