Subscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com
v4 GET /diving/get_calendar
Returns all tournaments of one year
Request URL
https://dsg-api.com/clients/{client_name}/diving/get_calendar?ts={tour_season_id}&client={client_name}&authkey={client_authkey}
Parameters
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'
ts
int Required
unique identifier for a whole season of the particular tour
Nodes
city
information about the city
city_id
unique identifier for cities
city_name
name of the city
competition
information about the competition
area_id
unique identifier for an area
area_name
name of the area
competition_id
unique identifier for a competition
competition_name
name of the competition
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
discipline
details about the discipline
age_group
defines the age group (senior,u23,u22,u21....)
discipline_id
unique identifier of the discipline
gender
determines the gender of the competition (male or female)
name
name of the discipline
type
type of discipline (contestant, contestant_team or team)
winner_id
unique ID of the winner
winner_name
common name of the tournament winner
method
details about the API function
method_id
unique ID of method
name
name of method
season
details about the 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
season_extra
extra information of the season
status
status of the season (Scheduled,Live,Played,Postponed,Cancelled)
surface
type of surface (grass, artificial turf, ice, sand, water, parquet, asphalt, snow, canvas, hard)
type
type of tournament at the particular tour
tour
details about the 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
logo
full path URL of logo for particular tour_season
name
name of the 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}/diving/get_calendar?ts={tour_season_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}/diving/get_calendar?ts={tour_season_id}&client={client_name}&authkey={client_authkey}"
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}/diving/get_calendar?ts={tour_season_id}&client={client_name}&authkey={client_authkey}"
		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}/diving/get_calendar?ts={tour_season_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success