Come creare e usare un token API
I token API consentono a un altro sistema di connettersi al tuo account TicketingHub. Per gestirli è necessario disporre dell’accesso amministratore.
A cosa serve un token API?
- Inviare dati di TicketingHub a un software di reportistica o a un data warehouse.
- Consentire a una piattaforma partner personalizzata di consultare prodotti e prezzi.
- Creare un’esperienza di prenotazione lato server che verifica la disponibilità in tempo reale.
Un token API non crea un collegamento integrato con Google Sheets. Consulta Come esportare i dati di TicketingHub e collegare altri strumenti per scegliere tra esportazioni CSV, Zapier, webhook e accesso API.
Abilitare l’accesso API
- Vai a Impostazioni → Funzionalità.
- Attiva Accesso API.
Questa impostazione è disponibile in modalità self-service. Dopo averla attivata, in Impostazioni verrà visualizzata la voce Token API.
Creare un token
- Vai a Impostazioni → Token API.
- Seleziona Genera token API.
- Inserisci un nome che identifichi il sistema che utilizzerà il token.
- Scegli API fornitori (V2) per la gestione dei fornitori, API Widget per la disponibilità e le prenotazioni oppure API OCTO per collegare sistemi compatibili con lo standard OCTO.
- Se hai scelto API fornitori (V2) o API OCTO, puoi selezionare Sola lettura se l’integrazione deve solo consultare i dati. Questa opzione non si applica ai token API Widget.
- Se necessario, aggiungi una data di scadenza e genera il token.
- Copia subito il token e conservalo in modo sicuro. Il token completo viene mostrato una sola volta.
Usare il token
Invia il token nell’header Authorization di ogni richiesta API:
Authorization: Bearer YOUR_TOKENUsa i token API solo in sistemi lato server sicuri. Non inserire un token nel codice del sito web, nelle email, nei messaggi di chat o nei documenti condivisi.
Revocare un token
Vai a Impostazioni → Token API e seleziona Revoca accanto al token. La revoca è immediata: il sistema collegato smetterà di funzionare finché non verrà utilizzato un token sostitutivo.
Quando viene creato un token, tutti gli amministratori dell’account ricevono un’email, così eventuali token creati inaspettatamente vengono notati rapidamente; consulta Email di sicurezza da TicketingHub. Crea un token separato per ogni integrazione, concedi solo gli accessi necessari e revoca i token che non sono più in uso. Per gli aggiornamenti basati sugli eventi, puoi preferire i webhook o l’integrazione con Zapier.