A cosa servono i token di accesso
Un token di accesso (chiamato anche chiave API) permette al tuo software, a uno sviluppatore o a uno strumento esterno di leggere i dati del tuo negozio tramite l'API di Storeep. Ogni token ha i propri permessi, il proprio intervallo di dati e la propria data di scadenza, così puoi dare a ogni strumento esattamente ciò che gli serve e toglierlo in qualsiasi momento senza condividere la tua password.
Apri Impostazioni > Token di accesso. Il pulsante Visualizza la documentazione apre il riferimento dell'API, con gli endpoint, come inviare il token e i limiti delle richieste. Condividi quella pagina con il tuo sviluppatore.
Vuoi invece collegare un assistente AI come Claude o ChatGPT? Questo non usa i token di accesso. Vedi Collegare un assistente AI.
Creare un token
Clicca su Crea nuovo token, compila il modulo e clicca su Crea.
- Nome token: un'etichetta per riconoscerlo nella lista, per esempio "Sincronizzazione contabilità". Lo vedi solo tu.
- Autorizzazioni: spuntane almeno una:
- Leggere i prodotti: elenchi dei prodotti, dettagli, varianti e inventario.
- Leggere gli ordini: storico degli ordini, dettagli, stati e righe d'ordine.
- Leggere i webhook: vedere le configurazioni dei webhook e i registri di consegna.
- Gestire i webhook: creare, aggiornare ed eliminare le iscrizioni ai webhook tramite l'API.
- Accesso ai dati: quanto indietro nel tempo il token può leggere.
- Ultime 24 ore: solo i dati creati nelle ultime 24 ore. L'opzione più sicura, adatta alle sincronizzazioni in tempo reale.
- Imposta data di inizio: solo i dati creati a partire da una data che scegli in Data di inizio accesso ai dati.
- Sempre: tutti i tuoi dati, senza limiti di data.
- Scadenza: Non scade mai, oppure Imposta data di scadenza per scegliere una data entro un anno. Dopo quella data il token smette di funzionare da solo.
Copia subito il token
Dopo aver cliccato su Crea, la finestra mostra Il tuo token di accesso con un pulsante di copia. Questo token viene mostrato una sola volta. Copialo e conservalo in un posto sicuro, come un gestore di password. Storeep non può mostrarlo di nuovo. Se lo perdi, elimina il token e creane uno nuovo.
Trattalo come una password. Non inserirlo mai nel codice di un sito web, in repository pubblici, in screenshot o in messaggi di chat.
La lista dei token
- Nome, con la data di creazione.
- Autorizzazioni: per esempio Lettura dei prodotti o Lettura ordini.
- Accesso ai dati: Ultime 24 ore, Tutti i dati oppure Da una data.
- Scadenza: una data, oppure Mai.
- Ultimo utilizzo: quando uno strumento ha usato il token l'ultima volta, oppure Mai.
C'è un numero massimo di token per negozio. Quando lo raggiungi, il pulsante Crea nuovo token scompare finché non ne elimini uno.
Modificare un token
Clicca su un token per cambiarne nome, permessi, accesso ai dati o scadenza. Il valore del token resta lo stesso, quindi lo strumento che lo usa continua a funzionare con le nuove regole.
Eliminare un token
Seleziona uno o più token e scegli Elimina token, oppure usa il pulsante cestino su una riga. Il token smette di funzionare immediatamente e qualsiasi strumento che lo usa riceve un errore.
Consigli
- Dai a ogni strumento il suo token, così puoi rimuoverne uno senza bloccare gli altri.
- Scegli l'intervallo di dati più piccolo che funziona.
- Imposta una data di scadenza per i freelance e i lavori una tantum.
- Un token che mostra Mai in Ultimo utilizzo da molto tempo probabilmente non serve. Eliminalo.
- Se vuoi che sia Storeep a inviare gli eventi degli ordini al tuo server, invece di essere il tuo server a chiederli, usa i webhook.