fullmetrixDocs

Chiavi API

Crea una chiave perché un altro strumento possa leggere i tuoi report Fullmetrix, conservala al sicuro e revocala quando non ti serve più.

Una chiave API è una password pensata per i software. Permette a uno strumento esterno di leggere i tuoi report Fullmetrix senza usare il tuo account personale. Ti servirà per tre usi.

  • Il connettore Looker Studio, per creare le tue dashboard Google.
  • L'API pubblica, così uno sviluppatore può portare i tuoi numeri in altri software, in un foglio di calcolo o in uno strumento di BI.
  • Il server MCP, per interrogare i tuoi dati da un assistente IA compatibile.

Una chiave dà accesso in lettura ai report dell'intera organizzazione, tutti i negozi compresi. Non può modificare le tue impostazioni né i tuoi dati.

Per gestire le tue chiavi, clicca su Impostazioni nella barra laterale, poi sulla scheda Chiavi API.

Scheda Chiavi API nelle Impostazioni con la tabella delle chiavi, le sue colonne Nome, Prefisso, Creato e Ultimo usato, e il pulsante Crea una chiave evidenziato in alto a destra

Crea una chiave

Apri la creazione della chiave

Clicca su Crea una chiave in alto a destra nel riquadro Chiavi API. Si apre la finestra Crea una chiave API.

Dai un nome alla chiave

In Nome chiave, scrivi il nome dello strumento che la userà, per esempio "Looker Studio" o "Foglio di gestione". Questo nome ti dice quale chiave revocare più avanti. Poi clicca su Crea una chiave, oppure premi Invio.

Copia la chiave

La chiave completa viene mostrata, con il messaggio Copia questa chiave adesso. Non verrà visualizzato nuovamente dopo aver chiuso questa finestra. Clicca sull'icona di copia a destra della chiave. Il messaggio Chiave copiata negli appunti lo conferma. Incollala subito nello strumento o nel tuo gestore di password.

Chiudi la finestra

Clicca su Fatto. La chiave compare nella tabella.

Finestra Crea una chiave API con una chiave che inizia con fmx_, l'avviso di copia e il pulsante di copia evidenziato

La chiave viene mostrata una sola volta

Non conserviamo la chiave in forma leggibile, quindi non possiamo mostrartela di nuovo. Se l'hai persa, creane una nuova e revoca la vecchia.

Ogni chiave inizia con fmx_. Se la creazione fallisce, compare il messaggio Creazione della chiave non riuscita. Riprova un po' più tardi.

Leggi la tabella delle chiavi

ColonnaCosa mostra
NomeIl nome che hai dato alla chiave
PrefissoI primi caratteri della chiave, per riconoscerla in uno strumento senza mostrarla per intero
CreatoLa data di creazione
Ultimo usatoLa data dell'ultima chiamata fatta con questa chiave, oppure un trattino se non è mai stata usata

Finché non esiste nessuna chiave, il riquadro mostra Nessuna chiave API ancora creata.

La colonna Ultimo usato ti aiuta a fare pulizia. Una chiave inutilizzata da mesi spesso appartiene a uno strumento abbandonato. Revocala.

Revoca una chiave

Revocare una chiave la disabilita per sempre. Fallo quando uno strumento non viene più usato, quando un collaboratore esterno lascia il tuo progetto, o se pensi che qualcun altro abbia visto la chiave.

Clicca su Revoca

Nella riga della chiave, clicca su Revoca.

Conferma

La finestra Revoca la chiave API ti ricorda che le integrazioni che usano questa chiave smetteranno di funzionare. Clicca su Revoca per confermare, oppure su Annulla.

Il messaggio Chiave API revocata lo conferma. La riga resta nella tabella con l'etichetta Revocata, come traccia. La revoca è immediata e non si può annullare. Per ricollegare lo strumento, crea una nuova chiave.

Tieni al sicuro le tue chiavi

Una chiave permette a qualcuno di leggere tutti i tuoi numeri di vendita. Trattala come una password.

  • Crea una chiave per ogni strumento, così puoi escluderne una senza toccare le altre.
  • Non inviarla mai in chiaro per e-mail o in chat, e non incollarla mai in una pagina pubblica o in un codice che i tuoi visitatori possono vedere.
  • Revocala non appena non ti serve più.

Non ti chiederemo mai una chiave API per e-mail o per telefono.

Domande frequenti

In questa pagina