Generic API

Import and synchronize participants' data from any online file.

Use generic API

Past the URL of your online participant file in order to import the participant data. The API checks the format of your file and provides feedback on which parameters are imported. The initial import can take up to 1 min.

Format of online participant file

starters
devices
times
starters

starters parameters to describe participant

parameter

description

importID

specific ID you assign to an entry, a new importID creates a new entry in the participant list

key

no import, if key does not belong to Racemap event

name

name of participant

startNumber

race number respectively bib of participant

markerColor

color of dots in tracking map, hex code

devices

devices parameters if GPS tracker respectively RFID chip is assigned to a participant

parameter

description

class

GPS tracker or RFID transponder

type

specific model e.g. "GL300"

id

EMEI or transponder ID of device

times

times parameters if reads or timestamps from timekeeping system are assigned to a participant, UTC format corresponding to ISO 8601 https://en.wikipedia.org/wiki/ISO_8601

parameter

description

start

when did the participant start

end

when did the participant finish

loop or 5km

reads from splits

{
"starters": [
{
"importId": "UniqueImportID_0",
"name": "Peter Pan Minimal",
"startNumber": "A1206"
},
{
"importId": "UniqueImportID_1",
"name": "Peter Pan With Color",
"startNumber": "A1207",
"markerColor": "#4d79ff"
},
{
"importId": "UniqueImportID_2",
"name": "Peter Pan With Tracker",
"startNumber": "A1208",
"devices": [
{
"class": "Tracker",
"type": "Gl300",
"id": "001111112222223"
}
]
},
{
"importId": "UniqueImportID_3",
"name": "Peter Pan With Times",
"startNumber": "A1209",
"times": {
"start": "2020-04-24T14:30:06.708Z",
"end": "2020-04-24T15:30:06.708Z",
"loop": "2020-04-24T15:15:06.708Z"
}
},
{
"importId": "UniqueImportID_4",
"name": "Peter Pan With Start and End Times",
"startNumber": "A1210",
"startTime": "2020-04-25T14:30:06.708Z",
"endTime": "2020-04-25T15:30:06.708Z"
}
]
}
<root>
<starters>
<importId>UniqueImportID_0</importId>
<name>Peter Pan Minimal</name>
<startNumber>A1206</startNumber>
</starters>
<starters>
<importId>UniqueImportID_1</importId>
<name>Peter Pan With Color</name>
<startNumber>A1207</startNumber>
<markerColor>#4d79ff</markerColor>
</starters>
<starters>
<importId>UniqueImportID_2</importId>
<name>Peter Pan With Tracker</name>
<startNumber>A1208</startNumber>
<devices>
<class>Tracker</class>
<type>Gl300</type>
<id>001111112222223</id>
</devices>
</starters>
<starters>
<importId>UniqueImportID_3</importId>
<name>Peter Pan With Times</name>
<startNumber>A1209</startNumber>
<times>
<start>2020-04-24T14:30:06.708Z</start>
<end>2020-04-24T15:30:06.708Z</end>
<loop>2020-04-24T15:15:06.708Z</loop>
</times>
</starters>
<starters>
<importId>UniqueImportID_4</importId>
<name>Peter Pan With Start and End Times</name>
<startNumber>A1210</startNumber>
<startTime>2020-04-25T14:30:06.708Z</startTime>
<endTime>2020-04-25T15:30:06.708Z</endTime>
</starters>
</root>