Sviluppatori

Chiavi API

Crea una chiave per il tuo software e inviala con ogni richiesta all'API di HANC.

Una chiave API permette al tuo software di usare l'API di HANC: elencare le chiamate, creare agenti, acquistare numeri, leggere il tuo CRM. Una chiave agisce con i tuoi permessi: ciò che puoi fare nella dashboard, lei può farlo tramite l'API.

Creare una chiave

1. Apri le chiavi

   Integrazioni → la scheda Sviluppatori → Chiavi API dello spazio.

2. Creane una

   Fai clic su Crei un token API. La chiave compare nell'elenco; il pulsante di visualizzazione la mostra e da lì puoi copiarla.

• Fino a 3 chiavi per workspace.
• Le chiavi non hanno un nome né permessi propri: una chiave ha il tuo accesso in ogni workspace di cui fai parte.
• Una chiave può essere mostrata di nuovo dall'elenco: tratta l'elenco come un dato riservato.

Usarla

Invia la chiave nell'header x-api-key, senza il prefisso Bearer:

curl "https://api.hanc.ai/v1/agent/list" \
  -H "x-api-key: YOUR_API_KEY"

Ogni endpoint è descritto nel Riferimento API.

Tienila al sicuro

• Tieni le chiavi sul tuo server, mai in un browser, in un'app mobile o in qualunque cosa un utente possa aprire.
• Non salvarle mai nel controllo di versione.
• Sostituiscile ogni tanto; elimina subito una chiave quando qualcuno se ne va o se potrebbe essere trapelata.

Vedi anche

• Riferimento API
• Webhook e consegna — i dati della chiamata inviati al tuo sistema dopo ogni chiamata