API pública · en desarrollo

Los datos en directo,
solo para quien tú autorices

Estamos construyendo una API de solo lectura para que partners, medios y desarrolladores integren los datos de Race Live Timing en sus propias webs y apps. El acceso será siempre mediante token, no hay API abierta. Esta página describe el diseño previsto; el acceso anticipado se concede bajo solicitud.

Seguridad por token

Token por partner

Cada integración recibe su propio token, enviado como Bearer. Sin token válido no hay respuesta de datos.

Alcance por evento

Un token solo ve las carreras y eventos que se le asignan, nunca el resto.

Límite de uso y caducidad

Cuota de peticiones por token y fecha de caducidad opcional, para proteger el directo.

Revocable al instante

Los tokens se guardan cifrados (solo hash) y se pueden revocar desde el panel sin afectar a los demás.

Endpoints previstos

Diseño provisional de la versión 1, sujeto a cambios hasta su publicación. Todo responde JSON y exige la cabecera Authorization.

curl https://racegolive.com/api/v1/events/<slug>/live \
  -H "Authorization: Bearer <tu-token>"
  • GET/api/v1/eventsEventos accesibles para el token
  • GET/api/v1/events/{slug}/liveEstado en vivo: checkpoints, atletas en carrera, últimas llegadas
  • GET/api/v1/events/{slug}/resultsClasificación paginada: general, categoría, sexo, equipos
  • GET/api/v1/events/{slug}/athletes/{bib}Un dorsal: tiempos de paso y posición
  • GET/api/v1/events/{slug}/routeTrazado del evento en GeoJSON