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_...| Endpoint | Restituisce |
|---|---|
GET /api/v1/me | Il tuo ID utente, nome ed email |
GET /api/v1/tours | I tour a cui hai accesso |
GET /api/v1/tours/:tourId/events | Gli 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.