Gestire le chiavi API

Crea, gestisci e revoca chiavi API per integrazioni esterne. Usale per autenticarti con la REST API di Bugalou.

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

  1. Clicca su “Crea chiave API” in alto a destra
  2. Inserisci un nome per la chiave (per esempio “API di produzione”, “Ambiente di staging”)
  3. Clicca su “Crea chiave”
  4. 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 personalizzato
  • Authorization: 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:

Non trovi quello che cerchi?

Chiedi direttamente a noi e riceverai una risposta personale.

Fai la tua domanda