Subscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com
GET /sailing/get_contestants
Returns a list of contestants
Request URL
https://dsg-api.com/clients/{client_name}/sailing/get_contestants?client={client_name}&authkey={client_authkey}&type=discipline&type_id={discipline_id}&season={season_id}
Parameters
area_id
int
area to get the subareas or specific area from
authkey
string Required
client authentification key
client
string Required
unique client ID
ftype
string
changes feed type from XML to json (ftype=json)
lang
string
two-character language code, defaults to 'en'
season
int Required
unique season identifier
type
string Required
type=discipline_id is required
type_id
int Required
discipline_id to be filtered
Nodes
contestant
details about the contestant
common_name
common name of the person
first_name
first name of the person
last_name
last name of the person
match_name
shortened match name of the person
nationality_area_code
three-letter acronym of the nationality
nationality_area_id
unique identifier for an area
nationality_area_name
area name of peoples nationality
people_id
unique identifier for 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
sport
sport of the API
version
version of the API
discipline
Basic information about the discipline
discipline_id
unique identifier of the discipline
name
name of the discipline
type
type of discipline (contestant or team)
gender
details about the gender
value
gender type (male, female or mixed)
method
details about the API function
method_id
unique ID of method.
name
name of method.
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}/sailing/get_contestants?client={client_name}&authkey={client_authkey}&type=discipline&type_id={discipline_id}&season={season_id}");
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}/sailing/get_contestants?client={client_name}&authkey={client_authkey}&type=discipline&type_id={discipline_id}&season={season_id}"
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}/sailing/get_contestants?client={client_name}&authkey={client_authkey}&type=discipline&type_id={discipline_id}&season={season_id}"
		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}/sailing/get_contestants?client={client_name}&authkey={client_authkey}&type=discipline&type_id={discipline_id}&season={season_id}", auth=("User", "Password"))
Response Example
200 Success