Passa al contenuto principale

Come creo una chiave API per un’integrazione?

In La mia azienda, apri API pubblica, crea una chiave con i permessi necessari e copiala: viene mostrata una sola volta.

In questa pagina

Sul web

  1. Apri l’azienda

    Seleziona La mia azienda Apri in Kinmu Richiede l’estensione API pubblica.

    Compare la configurazione aziendale.

  2. Apri l’API

    In Estensioni, seleziona API pubblica.

    Si apre la scheda delle chiavi API.

  3. Crea una chiave

    Seleziona Crea chiave API.

    Compare il modulo.

  4. Assegna un nome

    Compila Nome. Se puoi scegliere l’ambiente, seleziona produzione o sandbox, che usa un’azienda di prova con dati sintetici.

    Nome e ambiente sono impostati.

  5. Imposta la scadenza

    Scegli una durata oppure nessuna scadenza.

    Una chiave con scadenza smette automaticamente di funzionare alla data prevista.

  6. Scegli i permessi

    Seleziona solo quelli necessari all’integrazione.

    I permessi scelti compaiono nel modulo.

  7. Genera la chiave

    Seleziona Crea chiave.

    La chiave completa viene mostrata per l’unica volta.

  8. Copia la chiave

    Copiala, conservala in un posto sicuro e seleziona Fatto.

    La chiave compare mascherata nell’elenco.

Se non trovi l’opzione

  • Sul telefono, apri prima il menu con il pulsante del menu.
  • Servono l’estensione dell’API pubblica e il ruolo Amministratore Globale o Manager.
  • Se hai raggiunto il limite di chiavi attive, revocane una prima di crearne un’altra. Devi selezionare almeno un permesso.

Domande frequenti

Posso recuperare una chiave persa?

No. Ruotala o creane una nuova. Dopo la rotazione, la vecchia smette subito di funzionare: aggiorna le integrazioni.

Come blocco un’integrazione?

Revoca la sua chiave. L’effetto è immediato e irreversibile.

Risultato

La chiave è pronta per l’integrazione, che la invia nell’header Authorization: Bearer. La documentazione tecnica è su docs.kinmu.app.

Ti è stato utile?
Altre guide sull’argomento account, ia e integrazioni →

Non hai trovato la risposta? Scrivici