Salta ai contenuti
TicketingHub Help

Come creare e utilizzare un token API

I token API consentono a un altro sistema di connettersi al Suo account TicketingHub. Per gestirli è necessario disporre dell’accesso amministratore.

Per cosa posso utilizzare un token API?

  • Inviare i dati di TicketingHub a un software di reportistica o a un data warehouse.
  • Consentire a una piattaforma partner personalizzata di leggere prodotti e prezzi.
  • Creare un’esperienza di prenotazione lato server che verifichi la disponibilità in tempo reale.

Un token API non crea una connessione integrata a Google Sheets. Consulti Come esportare i dati di TicketingHub e collegare altri strumenti per scegliere tra esportazioni CSV, Zapier, webhook e accesso API.

Abilitare l’accesso API

  1. Vada a Impostazioni → Funzionalità.
  2. Attivi Accesso API.

Questa impostazione è disponibile autonomamente. Dopo averla abilitata, in Impostazioni comparirà Token API.

Creare un token

  1. Vada a Impostazioni → Token API.
  2. Selezioni Genera token API.
  3. Inserisca un nome che identifichi il sistema che utilizzerà il token.
  4. Scelga Supplier API (V2) per la gestione dei fornitori, Widget API per la disponibilità e le prenotazioni oppure OCTO API per collegare sistemi che utilizzano lo standard OCTO.
  5. Se ha scelto Supplier API (V2) o OCTO API, può selezionare Sola lettura quando l’integrazione deve soltanto visualizzare i dati. Questa opzione non si applica ai token Widget API.
  6. Aggiunga una data di scadenza, se necessario, quindi generi il token.
  7. Copi immediatamente il token e lo conservi in modo sicuro. Il token completo viene mostrato una sola volta.

Utilizzare il token

Invii il token nell’header Authorization di ogni richiesta API:

Authorization: Bearer YOUR_TOKEN

Utilizzi i token API esclusivamente in sistemi sicuri lato server. Non inserisca un token nel codice del sito web, nelle e-mail, nei messaggi di chat o nei documenti condivisi.

Revocare un token

Vada a Impostazioni → Token API e selezioni Revoca accanto al token. La revoca ha effetto immediato, quindi il sistema connesso smetterà di funzionare finché non utilizzerà un token sostitutivo.

Crei un token separato per ogni integrazione, conceda esclusivamente gli accessi necessari e revochi i token che non sono più in uso. Per gli aggiornamenti basati sugli eventi, potrebbe preferire i webhook o l’integrazione Zapier.