Skip to Content

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_...
EndpointDevuelve
GET /api/v1/meTu ID de usuario, nombre y correo electrónico
GET /api/v1/toursLas giras a las que tienes acceso
GET /api/v1/tours/:tourId/eventsEventos 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.

Last updated on