Keys and passcode

Through keys, you can sell live tracking in the online registration for your event. Merge the participant data (name and race number) with a specific key. Distribute the key with the registration email or as a printed QR code. Keys enable an automated and highly convenient sign-up process for live tracking.

Querying keys via the API

To automatically retrieve keys, use the following API route:

https://racemap.com/api/events/[evenId]/starter_keys?format=json

Example:

https://racemap.com/api/events/5dfce57c9240c60001f71a88/starter_keys?format=json

Note:

• Generate the keys beforehand.

• Additional keys can be generated at any time.

• Keys are charged only when a participant uses a key in the app or uploads an activity.

Generating QR code images

To generate a QR code image for a specific key, use this API endpoint:

https://racemap.com/api/starters/actions/generate_key_qrcode?key=[KEY]

Replace [KEY] with the desired key. For instance, to generate a QR code for the passcode 6G615L (from the "Easy QR Code Run" sample), use:

https://racemap.com/api/starters/actions/generate_key_qrcode?key=6G615L

This API call returns the QR code image, which you can embed or display directly in your application (e.g., within an email, newsletter, or dashboard).

Properties of keys and the passcode

• Assigned to ONE specific event,

• Can't be used for a different event,

• Six characters, upper or lower case is irrelevant.

• Each with a specific landing page URL: https://racemap.app/redeem_key?key=YYYYYY.

Read more about the synchronization of participant data with a Racemap event:

Learn more about keys to upload recorded activities from fitness trackers such as Garmin and Polar:

Connect RACEMAP App for live tracking

Participants require a key respectively the passcode to connect Racemap App (or a custom app) for live tracking in a specific event. There are three options for participants redeem their key in the app:

• Scan QR code.

• Press the key link

• Manually redeem the key in the search field of Racemap App.

Link to redeem a key in RACEMAP App

Information about deep links to directly call functions in Racemap App (or a custom app):

The key link provides a seamless user flow to connect the participants' phones for live tracking. The convenient user experience scales with a huge number of participants and saves support time. The process dynamically guides participants independent from

• The user's phone is iOS or Android.

• Racemap App is installed or not installed.

• The participant opens the key link on the smartphone or on the desktop.

• Add specific startNumber and name. Participants don't need to type their name and bib number. */redeem_key?key=KEY&startNumber=STARTNUMBER&name=NAME. Test this sample on your phone https://racemap.app/redeem_key?key=6G615L&startNumber=1&name=Peter .

Redeem key or passcode, manually

Redeem a key respectively the passcode in the search field of Racemap App.