No Subscription to this function
GET /water_polo/get_seasons
Returns all (authorized) seasons (that have been recently updated).
Request URL
https://dsg-api.com/clients/{client_name}/water_polo/get_seasons?comp_id={competition_id}&client={client_name}&authkey={client_authkey}
Parameters
authkey
string Required
client authentification key
client
string Required
unique client ID
comp_id
int Required
competition id to get seasons from
ftype
string
changes feed type from XML to json (ftype=json)
lang
string
two-character language code, defaults to 'en'
Nodes
competition
Details about competition
area_id
unique identifier for area.
area_name
contains the area name.
competition_id
unique identifier for a competition.
format
competition format to filter out leagues or cups
last_updated
When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
name
name of the competition.
teamtype
determines the type of team/competition (male,female,male_youth,female_youth)
type
determines if a competition is between club teams (club) or national teams (international).
method
details about the API function
method_id
unique ID of method.
name
name of method.
season
Details about season
end_date
end date, format 'yyyy-mm-dd'.
last_updated
when record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
logo
full path URL of logo for particular season
original_name
competition name during this season
season_id
unique identifier for season.
start_date
start date, format 'yyyy-mm-dd'.
title
title of season
Response Headers
200
Success
401
Unauthorized
429
Rate limit exceeded
Code Samples
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://dsg-api.com/clients/{client_name}/water_polo/get_seasons?comp_id={competition_id}&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}/water_polo/get_seasons?comp_id={competition_id}&client={client_name}&authkey={client_authkey}"
response = requests.get("https://dsg-api.com/clients/{client_name}/water_polo/get_seasons?comp_id={competition_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"2.0","sport":"water_polo","lang":"en","method":{"method_id":"214","name":"get_seasons"},"competition":{"competition_id":"1961","name":"FINA World Cup","teamtype":"male","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2019-06-09 18:57:45","season":[{"season_id":"18084","title":"2018 Berlin","original_name":"FINA World Cup","start_date":"2018-09-11","end_date":"2018-09-16","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1961_1.png","last_updated":"2018-09-11 13:26:51"},{"season_id":"16961","title":"2014 Kazakhstan","original_name":"FINA World Cup","start_date":"2014-08-19","end_date":"2014-08-24","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1961_1.png","last_updated":"2018-06-24 12:12:13"},{"season_id":"16962","title":"2010 Romania","original_name":"FINA World Cup","start_date":"2010-08-19","end_date":"2010-08-24","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1961_1.png","last_updated":"2018-06-24 13:51:59"},{"season_id":"16963","title":"2006 Hungary","original_name":"FINA World Cup","start_date":"2006-08-19","end_date":"2006-08-24","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1961_1.png","last_updated":"2018-06-24 13:52:00"},{"season_id":"16964","title":"2002 Yugoslavia","original_name":"FINA World Cup","start_date":"2002-08-19","end_date":"2002-08-24","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1961_1.png","last_updated":"2018-06-24 13:52:00"},{"season_id":"16965","title":"1999 Australia","original_name":"FINA World Cup","start_date":"1999-08-19","end_date":"1999-08-24","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1961_1.png","last_updated":"2018-06-24 13:52:00"},{"season_id":"16966","title":"1997 Greece","original_name":"FINA World Cup","start_date":"1997-08-19","end_date":"1997-08-24","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1961_1.png","last_updated":"2018-06-24 13:52:00"},{"season_id":"16967","title":"1995 United States","original_name":"FINA World Cup","start_date":"1995-08-19","end_date":"1995-08-24","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1961_1.png","last_updated":"2018-06-24 13:52:00"},{"season_id":"16968","title":"1993 Greece","original_name":"FINA World Cup","start_date":"1993-08-19","end_date":"1993-08-24","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1961_1.png","last_updated":"2018-06-24 13:52:00"},{"season_id":"16969","title":"1991 Spain","original_name":"FINA World Cup","start_date":"1991-08-19","end_date":"1991-08-24","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1961_1.png","last_updated":"2018-06-24 13:52:00"},{"season_id":"16970","title":"1989 Germany","original_name":"FINA World Cup","start_date":"1989-08-19","end_date":"1989-08-24","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1961_1.png","last_updated":"2018-06-24 13:52:00"},{"season_id":"16971","title":"1987 Greece","original_name":"FINA World Cup","start_date":"1987-08-19","end_date":"1987-08-24","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1961_1.png","last_updated":"2018-06-24 13:52:00"},{"season_id":"16972","title":"1985 Germany","original_name":"FINA World Cup","start_date":"1985-08-19","end_date":"1985-08-24","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1961_1.png","last_updated":"2018-06-24 13:52:00"},{"season_id":"16973","title":"1983 United States","original_name":"FINA World Cup","start_date":"1983-08-19","end_date":"1983-08-24","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1961_1.png","last_updated":"2018-06-24 13:52:00"},{"season_id":"16974","title":"1981 United States","original_name":"FINA World Cup","start_date":"1981-08-19","end_date":"1981-08-24","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1961_1.png","last_updated":"2018-06-24 13:52:00"},{"season_id":"16975","title":"1979 Yugoslavia","original_name":"FINA World Cup","start_date":"1979-08-19","end_date":"1979-08-24","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1961_1.png","last_updated":"2018-06-24 13:52:00"}]}}}