API para desarrolladores
La API para desarrolladores de TourPro permite que tus propios scripts e integraciones lean tus datos. El acceso funciona mediante tokens de acceso personal: cada token actúa en tu nombre y solo puede ver las giras a las que tú tienes acceso.
La Fase 1 es de solo lectura: puedes consultar tu identidad, tus giras y los eventos de la agenda.
Crear un token
Abre tu perfil
En la aplicación web, abre tu Perfil y selecciona la pestaña Desarrollador.
Crea el token
Haz clic en Crear token, asígnale un nombre (por ejemplo, el script o servicio que lo utilizará) y confirma.
Cópialo ahora
TourPro muestra el token una sola vez. Cópialo y guárdalo como una contraseña. Si lo pierdes, revócalo y crea uno nuevo.
Llamar a la API
Envía el token como credencial Bearer:
Authorization: Bearer tourpro_...| Endpoint | Devuelve |
|---|---|
GET /api/v1/me | Tu ID de usuario, nombre y correo electrónico |
GET /api/v1/tours | Las giras a las que tienes acceso |
GET /api/v1/tours/:tourId/events | Eventos de la agenda de una gira, filtrados según tus permisos y visibilidad |
La URL base es el host de la API (por ejemplo, https://api.tourpro.app), no la aplicación web.
curl https://api.tourpro.app/api/v1/tours \
-H "Authorization: Bearer tourpro_..."La API tiene un límite de 120 solicitudes por minuto por token. Si superas el límite, recibirás una respuesta 429 con cabeceras RateLimit que describen la ventana actual.
Revocar un token
De vuelta en la pestaña Desarrollador, haz clic en Revocar junto al token y confirma. La revocación es inmediata y permanente: crea un token nuevo si necesitas sustituirlo.
Qué puede ver un token
Un token nunca ve más que tú:
- Giras: solo las giras que creaste o a las que perteneces.
- Eventos: solo los eventos visibles para tu rol y tu rango de fechas en esa gira, y únicamente cuando tienes permiso para ver la agenda.
- Todo es de solo lectura. Nada en la API puede modificar tus datos.
Las sesiones iniciadas en la aplicación no funcionan en la API. Los endpoints v1 solo aceptan tokens tourpro_, por lo que una sesión de navegador robada no puede reutilizarse contra ellos.