Skip to Content

API per sviluppatori

L’API per sviluppatori di TourPro consente ai tuoi script e alle tue integrazioni di leggere i tuoi dati. L’accesso avviene tramite token di accesso personali: ogni token opera a tuo nome e può vedere solo i tour a cui hai accesso tu.

La Fase 1 è in sola lettura: puoi recuperare la tua identità, i tuoi tour e gli eventi in programma.

Creare un token

Apri il tuo profilo

Nell’app web apri il tuo Profilo e seleziona la scheda Sviluppatore.

Crea il token

Clicca su Crea token, assegnagli un nome descrittivo (ad esempio lo script o il servizio che lo userà) e conferma.

Copialo subito

TourPro mostra il token una sola volta. Copialo e custodiscilo come una password. Se lo perdi, revoca il token e creane uno nuovo.

Chiamare l’API

Invia il token come credenziale Bearer nell’header HTTP:

Authorization: Bearer tourpro_...
EndpointRestituisce
GET /api/v1/meIl tuo ID utente, nome ed email
GET /api/v1/toursI tour a cui hai accesso
GET /api/v1/tours/:tourId/eventsGli eventi in programma per un tour, filtrati in base alle tue autorizzazioni e alla visibilità

L’URL di base è l’host dell’API (ad esempio https://api.tourpro.app), non l’app web.

curl https://api.tourpro.app/api/v1/tours \ -H "Authorization: Bearer tourpro_..."

L’API ha un limite di 120 richieste al minuto per token. Superata la soglia riceverai una risposta 429 con gli header RateLimit che descrivono la finestra temporale.

Revocare un token

Torna nella scheda Sviluppatore, clicca su Revoca accanto al token e conferma. La revoca è immediata e definitiva: crea un nuovo token se ti serve sostituirlo.

Cosa può vedere un token

Un token non vede mai più di quanto veda tu:

  • Tour: solo i tour che hai creato o di cui fai parte.
  • Eventi: solo gli eventi visibili per il tuo ruolo e per le tue date su quel tour, e solo se disponi dell’autorizzazione per visualizzare il programma.
  • Tutto è in sola lettura. Nessun endpoint dell’API può modificare i tuoi dati.

Le sessioni di accesso dell’app non funzionano sull’API. Gli endpoint v1 accettano esclusivamente token con prefisso tourpro_, quindi una sessione del browser sottratta non può essere riutilizzata contro l’API.

Last updated on