Generic import

Import and synchronize participants from online files.

Past the URL of one online source to import participants and devices to the Racemap event. Import data from multiple online files, also. The generic import checks the format and provides feedback on which parameters are imported. 
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.
json sample file: https://racemap.com/files/GenericImportSample.json​
xml sample file: https://racemap.com/files/GenericImportSample.xml​
parameter
description
type
default
required
starters
parameters of participants
array
➖
✔️
devices
if GPS tracker respectively transponder is assigned to specific participant
array
➖
➖
times
if reads or detections from timekeeping system are assigned to participants, UTC corresponding to ISO 8601 https://en.wikipedia.org/wiki/ISO_8601​
object
➖
➖
starter object
device object
times object
parameter
description
sample
type
default
required
importID
user-defined ID, unique within Racemap event, assigned to specific participant, a new importID creates a new participant
import_DWBK, 03487, 1sl71kaut2
string
➖
✔️
key
no import if value of key does not belong to Racemap event
3Z2GPX
string
➖
➖
name
name of participant
Max, 🔥, 40012
string
➖
➖
startNumber
bib number of participant
40012, 🔥, Max
string
➖
➖
markerColor
color of marker in tracking map, hex code
#023d10
string
#ffffff
➖
tags
additional attributes to filter participants eg. age group or nation, format tag: value
Age: 35, Sex: male, Country: Island
object
➖
➖
parameter
description
sample
type
default
required
class
specific device class
Mobile, Tracker, Upload, Transponder, TrackPingTransponder
string
➖
➖
type
specific device type
GL300, LK106, active, passive
string
➖
➖
id
IMEI or transponder ID of device
4106050246, RRPing_ZDKAR32, RRPing_70761
string
➖
➖
parameter
description
sample
type
default
required
start
timestamp of when did the participant start
2021-10-23T00:35:00.000Z
string
➖
➖
end
timestamp of when did the participant finish
2021-10-23T01:15:59.710Z
string
➖
➖
loop or 5km
timestamp of read from split
2021-10-23T01:05:47.000Z
string
➖
➖
json
xml
{
"starters": [
{
"importId": "UniqueImportID_0",
"name": "Petra Pan Minimal",
"startNumber": "A1206",
"tags": {
"age": "25",
"sex": "w"
}
},
{
"importId": "UniqueImportID_1",
"name": "Peter Pan With Color",
"startNumber": "A1207",
"markerColor": "#4d79ff",
"tags": {
"age": "35",
"sex": "m"
}
},
{
"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>Petra Pan Minimal</name>
<startNumber>A1206</startNumber>
<tags>
<age>25</age>
<sex>w</sex>
</tags>
</starters>
<starters>
<importId>UniqueImportID_1</importId>
<name>Peter Pan With Color</name>
<startNumber>A1207</startNumber>
<markerColor>#4d79ff</markerColor>
<tags>
<age>35</age>
<sex>m</sex>
</tags>
</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>
sample file with wrong format:
json: https://racemap.com/files/GenericImportSampleWithErrors.json​
xml: https://racemap.com/files/GenericImportSampleWithErrors.xml​

parameter	description	type	default	required
`starters`	parameters of participants	array	➖	✔️
`devices`	if GPS tracker respectively transponder is assigned to specific participant	array	➖	➖
`times`	if reads or detections from timekeeping system are assigned to participants, UTC corresponding to ISO 8601 https://en.wikipedia.org/wiki/ISO_8601	object	➖	➖

parameter	description	sample	type	default	required
`importID`	user-defined ID, unique within Racemap event, assigned to specific participant, a new `importID` creates a new participant	import_DWBK, 03487, 1sl71kaut2	string	➖	✔️
`key`	no import if value of `key` does not belong to Racemap event	3Z2GPX	string	➖	➖
`name`	name of participant	Max, 🔥, 40012	string	➖	➖
`startNumber`	bib number of participant	40012, 🔥, Max	string	➖	➖
`markerColor`	color of marker in tracking map, hex code	#023d10	string	#ffffff	➖
`tags`	additional attributes to filter participants eg. age group or nation, format `tag: value`	Age: 35, Sex: male, Country: Island	object	➖	➖

parameter	description	sample	type	default	required
`class`	specific device class	Mobile, Tracker, Upload, Transponder, TrackPingTransponder	string	➖	➖
`type`	specific device type	GL300, LK106, active, passive	string	➖	➖
`id`	IMEI or transponder ID of device	4106050246, RRPing_ZDKAR32, RRPing_70761	string	➖	➖

parameter	description	sample	type	default	required
`start`	timestamp of when did the participant start	2021-10-23T00:35:00.000Z	string	➖	➖
`end`	timestamp of when did the participant finish	2021-10-23T01:15:59.710Z	string	➖	➖
`loop` or `5km`	timestamp of read from split	2021-10-23T01:05:47.000Z	string	➖	➖

Import with API, automatically

RACE RESULT import

Last modified 1mo ago