No Subscription to this function
GET /alpine_skiing/get_athlete_rankings
Returns world cup rankings for a specific year and/or discipline
Request URL
https://dsg-api.com/clients/{client_name}/alpine_skiing/get_athlete_rankings?ts={tour_season_id}&gender={gender}&disc={discipline}&client={client_name}&authkey={client_authkey}
Parameters
authkey
string Required
client authentification key
client
string Required
unique client ID
disc
string Required
unique identifier for the discipline
ftype
string
changes feed type from XML to json (ftype=json)
gender
string Required
gender ("male" or "female")
lang
string
two-character language code, defaults to 'en'
ts
int Required
unique identifier for a tour_season
Nodes
athlete
details about an athlete
athlete_id
unique identifier for an athlete
common_name
common name of the athlete
count
amount of points for the particular ranking
first_name
first name of the athlete
last_name
last name of the athlete
match_name
shortened name of the athlete
nationality
nationality of the athlete
nationality_area_id
unique identifier for area.
nationality_code
three-letter acronym of the nationality
position
position of the particular athlete for that race
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
method
details about the API function
method_id
unique ID of method.
name
name of method.
tour
details about a tour
gender
gender of the tour
name
name of the particular tour
tour_id
unique tour identifier
tour_type
defines if the tournament is part of a tour or not. If not then value "non-tour"
tour_season
details about a tour season
title
title of the particular tour season
tour_season_id
unique identifier of a tour season
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}/alpine_skiing/get_athlete_rankings?ts={tour_season_id}&gender={gender}&disc={discipline}&client={client_name}&authkey={client_authkey}");
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}/alpine_skiing/get_athlete_rankings?ts={tour_season_id}&gender={gender}&disc={discipline}&client={client_name}&authkey={client_authkey}"
response = requests.get("https://dsg-api.com/clients/{client_name}/alpine_skiing/get_athlete_rankings?ts={tour_season_id}&gender={gender}&disc={discipline}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"1.0","sport":"alpine_skiing","lang":"en","method":{"method_id":"175","name":"get_athlete_rankings"},"tour":{"tour_id":"6","name":"Alpine Skiing World Cup","gender":"both","tour_season":{"tour_season_id":"17","title":"2019","athlete_rankings":[]}}}}