Race Integration API

Set up RaceTime event and registrations from external data.

The Race Integration API is based on REST architecture and provides access to RaceTime service resources via the JSON interface. The API has been created to enable any registration service to offer its users with manual timing capabilities and the ability to create a race events based on their own data.

Authorization

In order to access the API, pass RaceTime account token in the X-RaceTime-Token header. This token can be generated in the RaceTime user's profile. The API user has the same permissions as the same user for normal account operations within the application.

We also support Firebase ID tokens. Pass it as the value of the Authorization header using the "Bearer" scheme.

General flow

Race object represents a race event in RaceTime. A Participan is a representation of an athlete who competing in the race. Participants are grouped under categories, which are represented by ParticipantCategory objects.

So, in order to set up a new event, the calling party need:

• Create the Race object.

• Create one or more ParticipantCategory objects.

• Register participants to the corresponding categories.

Once this is done, all entities will appear in RaceTime and the race can begin.