Publishing results to ResultSheet from other systems

Overview

Enables developers to publish results from other systems into a ResultSheet event, for example from chip timing platforms.

Structure

This is a restful API POST post type with the following format:

https://resultsheet.bubbleapps.io/api/1.1/wf/update_rider_result

where the body of the call contains the following parameters:

  • rs_event_id: the ResultSheet event ID of the event being modified
  • rider_number: the number of the rider having their result updated. If more than one rider has this number then all riders with this number will be updated
  • result: the result for this rider in the format hh:mm:ss.dd
  • split: the split number being updated. A value of “0” will update the finish time
  • passcode: the passcode associated with the event being modified

The result posted must be in the full hh:mm:ss.dd format and can be either “Actual Time” or “Watch Time” and will follow the configuration for that rider in the start sheet.

Authorisation

To use this API call, the following is required:

  • An Bearer authorisation token. Please contact us for this to be assigned to you, you will only need one authorisation token
  • Your ResultSheet user needs to be API enabled. Please contact us for this step, it will only need setting up once
  • Your chosen event needs to be API enabled. This can be enabled from the edit event screen once your ResultSheet user has been API enabled. You will need to enable each event you wish to be editable via the API

Result codes

Following the API call, the call will return “success” if the token authorisation was accepted with the following result codes:

  • E000 – result update successful
  • E100 – event not found
  • E200 – event not API enabled
  • E300 – rider not found
  • E400 – incorrect result format
  • E500 – incorrect event passcode
  • E600 – missing split number
  • E700 – trying to update a split number that doesn’t exist

Example

To call the API, perform the following:

  1. Ensure you have received your Bearer token and had your user API enabled by contacting us
  2. Create an event in ResultSheet and save it
  3. Edit the event again and check the “Enable API for event?” box
  4. Copy both the Event ID and Event Passcode to your clipboard using the “Copy event ID” and “Copy event passcode” links on the edit event page. Keep these safe as you will need them when making the API call
  5. Click “Save Changes” to save the event again. Your event is now API enabled
  6. Upload your startsheet within ResultSheet as normal

You should now be able to call the API for this event.

For example, to update rider 15 with a finish time of 24:31 for ResultSheet event 123456789, the parameters would be:

  • rs_event_id: 123456789
  • rider_number: 15
  • result: 00:24:31.00
  • split: 0
  • passcode: 987654

The Bearer token would also go into the request call header.

Related Posts

Back To Top