This is an old revision of the document!


API

General

When on the same local network as the master timing computer, the built-in web server can be used to access results data live from the software.

This can for instance be useful for TV production, custom big screen displays etc.

The basic endpoint is the same as the regular web interface/commentator display (for example http://localhost). All requests are made using GET requests to the specific endpoints, with any parameters added as query string parameters. The response will be given in JSON format.

Endpoints

All endpoints should be prefixed with /api/1.1. Example: http://localhost/api/1.1/event/races

Endpoint Parameters Description
/event/races None List all races
/event/waves None List all waves
/timing/locations None List all timing locations
/timing/points None List all timing points
/timing/raceclock race_id (required) Get the current race clock and gun start time of a given race
/results/toplist race_id (required),
page, page_size
List all finishers of the given race, in position order
/results/toplistforpoint race_id (required),
point_id (required),
gender (optional),
page, page_size
List all participants, in position order for a specific timing point
/results/latest point_id,
location_id,
page, page_size
List the most recent passes of either a specific timing point or timing location (one of the is required )
/results/list race_id,
racenum,
search,
page, page_size
List all results in the event, regardless of finish status. Optional filtering on race, race number or text search
/results/leaders race_id (required),
gender (optional),
page_size
Show the leaderboard of a specific race, optionally filtered by gender
/results/participant race_id (optional),
result_id (optional)
racenum (optional)
Get the result of a single participant, including split times. At least one of result_id or racenum should be specified. race_id can be used to distinguish if multiple participants have the same race number.

Default values if not set: page =1, page_size = 50.

WebSocket push

If is possible to get pushed some basic events via a WebSocket connection. It is important to net that WebSockets are not supported via a BBT Extender connection. The endpoint to register and receive events is:

/api/1.1/push?events=xxx (xxx is a comma-seperated list of one or more event types to subscribe for)

The events will be pushed whenever they occur in JSON format. They all have a basic structure indicating the event type. Depending on the event, more data might be included. {“event”:“xxx”}

Event type Description
results Every time a result is recomputed or changed, this will trigger an event. The event will include the basics of the result (id, race, finish time etc).
eventdata Some event data was added or modified. This might be races, waves, settings, timing setup etc. The event will currently not include any detail about the change.