Generic API

Import and synchronize participants from online file.

Past the URL of the online source to import the participants to the Racemap event. The generic API checks format of your file and provides feedback on which parameters are imported. Import data from multiple online files, also.

past URLs of online sources to import the participants into Racemap event

Format of online participant file

Test the API with your Racemap event. Use the sample files.

parameter

description

starters

parameters of participant

devices

if GPS tracker respectively transponder assigned to participant

times

if reads or detections from timekeeping system assigned to participant, UTC corresponding to ISO 8601 https://en.wikipedia.org/wiki/ISO_8601

starters
devices
times
starters

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 respectively bib number of participant

markerColor

color of dots in tracking map, hex code

devices

description

class

GPS tracker or RFID transponder

type

specific model e.g. "GL300"

id

EMEI or transponder ID of device

times

parameter

description

start

when did the participant start

end

when did the participant finish

loop or 5km

reads from splits

json
xml
json
{
"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"
}
]
}
xml
<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>