Subscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com
v2 GET /multisport/get_records
Returns a list of contestants
Request URL
https://dsg-api.com/clients/{client_name}/multisport/get_records?client={client_name}&authkey={client_authkey}&id={multisport_event_season_id}&cat=summary
API Threshold
- 10k calls per hour (2.78 calls per second)
- This threshold applies to ALL your calls you do across the API.
- Your number of calls get reset every hour at :00
- If the thresold is reached within the hour you will get a xml/json message accordingly (which is gone when the next hour starts, see previous point)
Parameters
authkey
string Required
client authentification key
client
string Required
unique client ID
id
int Required
multisport_event_season_id to return
lang
string
two-character language code, defaults to 'en'
sport
string
sport to filter the output
Nodes
contestant❯
details about the record contestant
common_name
common name of the person
first_name
first name of the person
last_name
last name of the person
nationality_area_code
three character area code
nationality_area_id
unique identifier for an area
nationality_area_name
area name of peoples nationality
people_id
unique identifier for person
position
position value
short_name
shortened name of the person
datasportsgroup❯
details about the API version, sport, language and generation timestamp
generated_utc
UTC timestamp when the API output was generated
lang
language of the API call
sport
sport value
version
version of the API
day❯
information about the particular day
date
date format YYYY-MM-DD
discipline❯
basic information about the discipline
discipline_id
unique identifier of the discipline
name
name of the discipline
type
type of discipline (contestant, contestant_team or team)
method❯
details about the API function
method_id
unique ID of method
name
name of method
multisport_event❯
basic informations about the multisport event
area_code
three character area code
area_id
unique identifier for an area
area_name
name of the area
gender
determines the gender of the competition (male or female)
multisport_event_id
unique identifier for multisport events
multisport_event_name
general name of the multisport events
multisport_event_season❯
basic informations about the multisport event season
end_date
end date, format 'yyyy-mm-dd'
multisport_event_season_id
unique identifier for multisport event season
multisport_event_season_name
general name of the multisport event season
start_date
start date, format 'yyyy-mm-dd'
round❯
details about the round
end_date
end date, format 'yyyy-mm-dd'
end_date_utc
end date in UTC timezone, format 'yyyy-mm-dd'
end_time
end time, format 'HH:mm:ss'
end_time_utc
end time in UTC timezone, format 'HH:mm:ss'
last_updated
When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
name
name of round
round_id
unique identifier of round
start_date
start date, format 'yyyy-mm-dd'
start_date_utc
start date in UTC timezone, format 'yyyy-mm-dd'.
start_time
start time, format 'HH:mm:ss'
start_time_utc
start time in UTC timezone, format 'HH:mm:ss'
type
determines if the round contains a table or a cup structure (knock-out)
sport❯
basic information of the sport
sport
sport value
sport_name
name of the sport
Response Headers
200
Success
401
Unauthorized
429
Too Many Requests
Code Samples
<?php$ch = curl_init();curl_setopt($ch, CURLOPT_URL, "https://dsg-api.com/clients/{client_name}/multisport/get_records?client={client_name}&authkey={client_authkey}&id={multisport_event_season_id}&cat=summary");curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);curl_setopt($ch, CURLOPT_USERPWD, "{User}:{Password}");$content = curl_exec($ch);curl_close($ch);?>curl GET -u "User:Password" "https://dsg-api.com/clients/{client_name}/multisport/get_records?client={client_name}&authkey={client_authkey}&id={multisport_event_season_id}&cat=summary"
Imports System
Imports System.Net
Imports System.IO
Imports System.Text
Public Module Module1
Public Sub Main()
Dim url As String = "https://dsg-api.com/clients/{client_name}/multisport/get_records?client={client_name}&authkey={client_authkey}&id={multisport_event_season_id}&cat=summary"
Dim myReq As WebRequest = WebRequest.Create(url)
myReq.Credentials = new System.Net.NetworkCredential("{User}", "{Password}")
Dim wr As WebResponse = myReq.GetResponse()
Dim receiveStream As Stream = wr.GetResponseStream()
Dim reader As StreamReader = New StreamReader(receiveStream, Encoding.UTF8)
Dim content As String = reader.ReadToEnd()
End Sub
End Module
response = requests.get("https://dsg-api.com/clients/{client_name}/multisport/get_records?client={client_name}&authkey={client_authkey}&id={multisport_event_season_id}&cat=summary", auth=("User", "Password"))
Response Example200 Success