Skip to main content
Una chiave API è una «password per programmi»: la dai al tuo gestionale, al CRM o a chi sviluppa per te, e da quel momento il programma può parlare con il tuo centralino attraverso le API di MyCentralino. Questa guida ti porta dalla creazione della chiave alla prova, e spiega come bloccarla.

​
Cosa ottieni

  • Una chiave che inizia con sk_mycentralino_, valida per il tuo centralino.
  • Un programma esterno che legge interni, chiamate, code e numeri, e gestisce per esempio rubrica, interruttori e numeri bloccati. L’elenco completo è nella documentazione API.
  • Il controllo dal pannello: vedi quando la chiave è stata usata l’ultima volta, quante richieste stai facendo, e puoi disattivarla con un clic.

​
Prima di cominciare

  • Chi può farlo. Il titolare dell’account sempre; un collaboratore solo se gli hai concesso Gestione API. Vedi Aggiungere un collaboratore.
  • Dove la incollerai. Tieni aperto il programma (o il messaggio per lo sviluppatore) in cui va la chiave: la chiave si vede una sola volta, al momento della creazione.
  • Un nome per riconoscerla. Una chiave per ogni programma, con un nome chiaro (per esempio Gestionale o CRM), ti permette poi di bloccarne una senza fermare le altre.
  • Non serve nessun modulo in più.

​
Come fare

​
1 · Crea la chiave

Dove si trova: barra in alto → icona con l’omino (Il tuo account) → Il mio account → scheda Accessi e sicurezza → sezione Chiavi API, in fondo · https://cloud.mycentralino.com/account/profile?tab=api
1

Premi Nuova chiave

Il bottone è nella card Le tue chiavi API, accanto al conteggio «N/5 chiavi attive». Si apre la finestra Crea nuova API Key.
2

Dai un nome alla chiave

In Nome della chiave scrivi dove la userai, per esempio Gestionale. È facoltativo (al massimo 100 caratteri); se lo lasci vuoto la chiave si chiama «Chiave API».
3

Premi Crea chiave

In alto compare il riquadro La tua nuova API Key con la chiave completa e il messaggio «Chiave creata. Copiala ora: per sicurezza non sarà più visibile.».
4

Copia la chiave

Premi Copia e incollala subito nel programma, o in un posto sicuro. Quando hai finito chiudi il riquadro con la X («Ho copiato la chiave»).
Dopo aver chiuso il riquadro la chiave non si può più vedere né recuperare: nella tabella resta solo il suo inizio seguito da «…». Se la perdi, ne crei una nuova.

​
2 · Usa la chiave nel programma

Il programma deve mandare la chiave in ogni richiesta, nell’intestazione X-API-Key. L’indirizzo delle API è https://api.mycentralino.com. Lo stesso esempio è nella card Documentazione API del pannello, con il bottone Vai alla documentazione.
Tutto il resto (le funzioni disponibili, i parametri, le risposte e gli errori) è nella documentazione API: è la pagina da dare a chi sviluppa.

​
3 · Prova che funziona

1

Fai una richiesta di prova

Dal programma o da un terminale chiama https://api.mycentralino.com/v1/account con l’intestazione X-API-Key e la tua chiave. Se nella risposta c’è "success": true, la chiave funziona.
2

Controlla nel pannello

In Chiavi API, sulla riga della chiave, Ultimo utilizzo non dice più «Mai utilizzata» ma la data e l’ora della richiesta. Nella card Utilizzo vedi le richieste del minuto e del giorno.

​
4 · Blocca o sostituisci una chiave

​
Cosa trovi nella sezione Chiavi API

​
Da sapere

  • Si vede una volta sola. «Le chiavi API sono mostrate una sola volta al momento della creazione. Non è possibile recuperarle in seguito.»
  • Al massimo 5 chiavi attive. Le chiavi revocate non contano: per crearne una nuova basta revocarne o eliminarne una.
  • I limiti sono del centralino, non della chiave. Tutte le chiavi attive condividono le richieste al minuto e al giorno indicate nella card Utilizzo. Se te ne servono di più, usa Contattaci nella stessa card.
  • Una chiave, un centralino. La chiave vale solo per il centralino su cui l’hai creata.
  • Trattala come una password. Con la chiave un programma può anche far partire chiamate (che consumano credito) e cambiare interruttori, rubrica e numeri bloccati. Non metterla in pagine web, email o documenti condivisi.
  • Non scade da sola. Resta valida finché non la revochi o la elimini. Usa Ultimo utilizzo per capire se una vecchia chiave è ancora in uso prima di eliminarla.

​
Domande frequenti

No, per sicurezza si vede solo alla creazione. Crea una Nuova chiave, mettila nel programma e poi revoca o elimina quella persa.
Hai già 5 chiavi attive. Revocane o eliminane una che non usi più.
Sei un collaboratore senza il permesso Gestione API: chiedi al titolare di aggiungerlo al tuo utente.
Se dice che la chiave manca, il programma non manda l’intestazione X-API-Key. Se dice «API key non valida o scaduta», la chiave è sbagliata, revocata o eliminata: controlla in Chiavi API che sia Attiva.
Ha superato le richieste al minuto o al giorno del centralino, che valgono per tutte le chiavi insieme. Va rallentato; se te ne servono di più usa Contattaci nella card Utilizzo.
No, solo per quello su cui l’hai creata. Per un altro centralino crea una chiave lì.
Premi Riattiva sulla sua riga: torna attiva subito.
Nella documentazione API, che si apre anche dal bottone Vai alla documentazione nel pannello.

​
Pagine collegate

Chiavi API

La sezione Chiavi API nel dettaglio.

Documentazione API

Funzioni, parametri, risposte ed errori delle API.

Utenti e permessi

Dare la gestione delle chiavi a un collaboratore.

Il mio account

Le schede dell’account e la sicurezza.