Documentazione

Chiavi API

Genera e gestisci chiavi API per l'accesso programmatico.

Le chiavi API abilitano l'accesso programmatico ai tuoi agenti. Usale per integrare Agentkit nelle tue applicazioni o collegare servizi di terze parti.

Nota: le chiavi API richiedono un piano Hobby o superiore con fatturazione attiva. I workspace Free, con pagamento scaduto o non pagati non hanno accesso all'API. Passa a un piano superiore →

Creare una chiave API

  1. Vai al tuo workspace
  2. Fai clic su Chiavi API nella barra laterale
  3. Fai clic su Crea chiave API
  4. Conferma nella finestra di dialogo

La nuova chiave appare nell'elenco e può essere rivelata o copiata in qualsiasi momento.

Visualizzare e copiare le chiavi

Ogni chiave nell'elenco è mascherata per impostazione predefinita. Usa l'icona a forma di occhio per rivelare una chiave e l'icona di copia per copiarla negli appunti.

Usare le chiavi API

Includi la chiave nelle richieste API:

curl -X POST 'https://your-domain.com/api/v1/chat' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"chatbotId": "uuid", "messages": [{"role": "user", "content": "Hello"}]}'

Documentazione API completa →

Gestire le chiavi

Visualizzare tutte le chiavi

Tutte le chiavi del workspace sono elencate nella pagina Chiavi API.

Eliminare una chiave

  1. Trova la chiave nell'elenco
  2. Fai clic sull'icona del cestino
  3. Conferma l'eliminazione

Le chiavi eliminate smettono di funzionare immediatamente.

Best practice di sicurezza

Non esporre mai le chiavi

  • Non fare commit delle chiavi nei repository git
  • Non includere le chiavi nel codice lato client
  • Usa variabili d'ambiente

Ruota le chiavi periodicamente

  • Crea nuove chiavi periodicamente
  • Aggiorna le tue applicazioni
  • Elimina le chiavi vecchie

Usa chiavi separate

Crea chiavi diverse per:

  • Produzione e sviluppo
  • Applicazioni diverse
  • Membri del team o servizi diversi

Ambito delle chiavi

Le chiavi API sono limitate al workspace in cui vengono create e hanno accesso a:

  • Tutti gli agenti del workspace
  • Endpoint dell'API di chat
  • Gestione dei webhook

Le chiavi non possono:

  • Gestire i membri del team
  • Accedere alla fatturazione
  • Creare altre chiavi API

Connessione con Zapier

Quando ti connetti a Zapier:

  1. Crea una chiave API dedicata per Zapier
  2. Usa questa chiave nella connessione con Zapier
  3. Tieni questa chiave separata da altri usi

Configura Zapier →

Risoluzione dei problemi

Errore "Invalid API key"

  • Verifica che la chiave sia stata copiata correttamente
  • Controlla che non ci siano spazi iniziali o finali
  • Verifica che la chiave non sia stata eliminata

Errore "Key not authorized"

  • Assicurati che l'agente appartenga al tuo workspace
  • Verifica che il workspace della chiave corrisponda
  • Verifica che il tuo workspace sia su un piano Hobby o superiore con fatturazione attiva

La chiave non funziona dopo la creazione

  • Prova ad aggiornare la pagina
  • Attendi 30 secondi per la propagazione
  • Crea una nuova chiave se il problema persiste

Prossimi passi