# Keys and passcode ![Participants use the passcode or keys to easily connect RACEMAP App for live tracking. ](/files/Cx1reJbxKatWT9znOna4) {% hint style="success" %} Test live tracking of the event "Easy QR Code Run" with RACEMAP App (passcode 6G615L): * Leaderboard: [racemap.com/timing/qrcode-test](https://racemap.com/timing/qrcode-test) * Tracking map: [racemap.com/player/qrcode-test](https://racemap.com/player/qrcode-test?embed=true) There are two options for automatically connecting RACEMAP App for live tracking in this event: * Click the link * Scan the QR code (which is equal to the key link)\ After sign-up, you can contribute your activities to the activity challenge. {% endhint %} Keys are specific [deep links](/apps/tracking/deep-links.md) that target functions in our apps. Through keys, you can sell live tracking in the online registration for your event. Merge the participant data with a specific key. Distribute the key with the registration email or as a printed QR code. Keys enable an automated and convenient process for live tracking with RACEMAP apps. ## APIs for keys You can automatically process keys through APIs, e.g., when selling live tracking in an online registration platform. You need to authenticate the requests to the APIs. {% content-ref url="/pages/1bq15cJtzdnjBPSV9Bx7" %} [Authentication](/api/authentication.md) {% endcontent-ref %} #### Generating keys via API Endpoint to automatically generate keys on demand: ```json https://racemap.com/api/events/:eventId/actions/generate_starter_keys?count=10 ``` Replace `:eventId` with the id of your addressed event. Set the number according to your demand, eg. `11` to generate 11 keys. More keys can be generated at any time. #### Querying keys via API Endpoint to automatically retrieve keys: ```json https://racemap.com/api/events/:evenId/starter_keys?format=json ``` #### Generating QR code images Endpoint to generate a QR code image for a specific key: ```json 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: ```json https://racemap.com/api/starters/actions/generate_key_qrcode?key=6G615L ``` The API request 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: `https://racemap.app/redeem_key?key=[key]`. | Application | Keys | Passcode | | ------------------------------------------------------ | --------------------------------------------------------------------------------------- | ----------------------------------------------------- | | Usage for the event | Multiple keys for one event | One passcode for one event | | Usage by participants | Personalized: each participant uses a different key | Each participant uses the same passcode for one event | | Merge with participant data | Match participant's name & race number with a specific key eg. in registration platform | No match with individual participant data possible | | Assign location data during the event - Total activity | Accumulate multiple activities with Racemap App | Accumulate multiple activities with Racemap App | | Assign location data - Sum-up activities | With Racemap App and upload recorded activities | With Racemap App, only | Read more about the synchronization of participant data with an event in RACEMAP: {% content-ref url="/pages/-M3ehZR5FRb3OtNJtvds" %} [Import participant data](/api-import-and-export-data.md) {% endcontent-ref %} Learn more about keys to upload recorded activities from fitness trackers such as Garmin and Polar: {% content-ref url="/pages/-M4xF32x9PizOpA8KNfE" %} [Activity upload](/live-tracking/activity-upload.md) {% endcontent-ref %} ## Connect RACEMAP App for live tracking Participants require a key to connect RACEMAP App for live tracking in one specific event. There are three options for participants to redeem their key in the app: * Scan QR code. * Click the key link. * Manually paste the key in the search field of RACEMAP App. #### Link to **redeem a key in RACEMAP App** `https://racemap.app/redeem_key?key=[key]` 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. ![Key link landing page on desktop guides participants using their phones](/files/9RzFWxiSaP8CHVieeUOT) {% tabs %} {% tab title="RACEMAP App is not installed " %} ![](/files/iKicg8FKG2DL9vbROzpr) The key link forwards to the App Store or to Google Play to install the tracking app. {% endtab %} {% tab title="RACEMAP App is installed" %} ![](/files/5Wczco0xAsvNTDb4EXCo) The key link * Opens RACEMAP App. * Addresses the corresponding event. Participants don't search for their race. * Automatically redeems the key. Participants don't type the six characters of the key. {% endtab %} {% endtabs %} ![QR code on race kit to connect RACEMAP App for live tracking at ooredo marathon ](/files/-LVgzaDiRVDIcs4O6WxP) * 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 . #### **Redeem key manually** Redeem a key respectively the passcode in the search field of RACEMAP App. ![](/files/DdNRkO7LwzDxTzfffRzX) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.racemap.com/apps/tracking/keys.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.