No Subscription to this function
GET /table_tennis/get_matches
Returns all matches of a particular tournament
Request URL
https://dsg-api.com/clients/{client_name}/table_tennis/get_matches?type=season&id={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)
id
int Required
object id to return
lang
string
two-character language code, defaults to 'en'
type
string Required
one of ‘season’, ‘round’ or ‘match’ to which the "id" refers
Nodes
match
Details about the particular match
contestant_a_common_name
common name of the contestant
contestant_a_draw_position
darw position of the contestant
contestant_a_first_name
first name of the contestant
contestant_a_id
unique identifier for the contestant
contestant_a_last_name
last name of the contestant
contestant_a_nationality
nationality of the contestant
contestant_a_seeding
seeding of the contestant
contestant_b_common_name
common name of the contestant
contestant_b_draw_position
darw position of the contestant
contestant_b_first_name
first name of the contestant
contestant_b_id
unique identifier for the contestant
contestant_b_last_name
last name of the contestant
contestant_b_nationality
nationality of the contestant
contestant_b_seeding
seeding of the contestant
date
Date of match, format 'yyyy-mm-dd' (CET)
final_period
display the period in which the match finished. ('soc_p2s','soc_ets','soc_pen')
last_updated
When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
match_id
unique identifier of match.
score_a
full-time score of home team, including any goals in extra-time
score_b
full-time score of home team, including any goals in extra-time
status
status of the game (Playing, Break, Played, Fixture, Postponed, Awarded, Cancelled, Suspended)
time
start time (CET), format 'hh:mm:ss'.
winner
determines the winner of match ('team_A','team_B','draw','yet unknown')
method
details about the API function
method_id
unique ID of method.
name
name of method.
round
Details about round
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.
name
name of round
round_id
unique identifier of round.
start_date
start date, format 'yyyy-mm-dd'.
type
Determines if the round contains a table or a cup structure (knock-out).
set
details about the particular set
score_a
score for contestant_a
score_b
score for contestant_b
tie_break_score_a
tie-break score for contestant_a
tie_break_score_b
tie-break score for contestant_b
winner
winner of the particular set
tour
details about a tour
gender
gender of the tour
name
name of the particular tour
tour_id
unique tour identifier
tournament
details about a specific tournament
gender
defines if male or female playing the tournament, additionally mix is possible
season_id
unique identifier of an particular edition of the tournament
season_name
name of the tournament for this particular year (including sponsor names etc)
season_title
title of the season including gender and type (single,double,mix)
single_double
defines if this is Singles, Doubles or Mix tournament
surface
surface the tournament will be played on (Hard, Clay, Grass)
tournament_id
unique identifier for a tournament
tournament_name
general name of the tournament (without sponsor names etc)
type
type of tournament at the particular tour
winner
unique identifier of the contestant who won the tournament
winner_name
name of the contestant who won the tournament
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
Rate limit exceeded
Code Samples
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://dsg-api.com/clients/{client_name}/table_tennis/get_matches?type=season&id={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}/table_tennis/get_matches?type=season&id={season_id}&client={client_name}&authkey={client_authkey}"
response = requests.get("https://dsg-api.com/clients/{client_name}/table_tennis/get_matches?type=season&id={season_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success