Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

Description

Returns the seasons played in the competitions.

Package

This method is included in the  STATISTICS package.

Parameters

NameTypeDescription
usernamexsd:stringREQUIRED. Assigned to you by softnetSPORT administrator
pagexsd:intDetermines offset of paginated data. Default value is 1 which means first page
limitxsd:int

Determines maximum number of returned records on page. Used in paginated data. Default value is 500

Possible values: 5, 10, 25, 50, 100, 250, 500

sport_idxsd:intDetermines sport to which season belongs. softnetSPORT API provides the following sports: sports.index
competition_idxsd:intDetermines competition to which competition belongs. softnetSPORT API provides the following competitions: competitions.index
season_namexsd:stringDetermines the season name f.e 2014/15, 2015. softnetSPORT API provides the following seasons names: seasons_names.index
timestamptimestampxsd:unix_timestampSelection date, format UNIX_TIMESTAMP. Only changes in seasons or stages which occured or was updated after this timestamp will be returned.

Method calling examples

Link
Description
https://api.softnetsport.com/v2/seasons.xml?username=softnetsportReturns the list of seasons names in XML format
https://api.softnetsport.com/v2/seasons?username=softnetsportReturns the list of seasons names in JSON format
https://api.softnetsport.com/v2/seasons.xml?username=softnetsport&competition_id=1507Returns the seasons played in the competition - Primera Division
https://api.softnetsport.com/v2/seasons.xml?username=softnetsport&sport_id=5Returns the all competitions seasons played in soccer
https://api.softnetsport.com/v2/seasons.xml?username=softnetsport&season_name=2014/15Returns the all competitions seasons played in the season 2014/15.

Output elements

 

.competition
 
idUnique identifier for competition
nameName of  the competition i.e. U19 World Champ.
short_nameShorter name of competition i.e. U19 WCH, Max 20 characters.
mini_name

Max 3 characters length mini name i.e. U19

gender

Competition gender. Could be:

  • male
  • female
  • mixed
  • undefined
type

Competitions type. Could be:

  • country_league - i.e. Premier Division
  • country_cups - i.e. FA Cup
  • international - i.e. World Cup
  • international_clubs - i.e. Champions League 
  • friendly - friendly matches
  • individual - for speedway individual competitions such as Speedway GP
  • team - for speedway national competitions
  • single - for tennis competitions
  • double - for tennis competitions
  • mixed - for tennis competitions
  • undefined - other
area_idUnique identifier of area in which competitions are played. softnetSPORT API provides the following areas: areas.index
area_nameName of area in which competitions are played.
area_type

 Type of area in which competitions are played. Possible values:

  • country
  • international
area_sortNumeric value indicating the order within area in which competitions are played. I.e. Premier League is 1st and the Championship League is 2nd in English competitions
area_codeMax 3 characters length of area in which competitions are played. 
overall_sortNumeric value indicating the order within global competitions
sport_idUnique identifier of sport in which competition is played. softnetSPORT API provides the following sports: sports.index
sport_nameName of the sport in which competition is played.
utInformation about date and time when record was last updated. Format YYYY-MM-DD HH:MM:SS. UTC timezone.
..seasons
 
...season
 
idUnique identifier for the season
nameName of the season
utInformation about date and time when record was last updated. Format YYYY-MM-DD HH:MM:SS. UTC timezone.
....stages
 
.....stage
 
idUnique identifier for the stage
nameName of the stage
sortThe sort order for stage
is_current

Possible values:

  • yes
  • no
utInformation about date and time when record was last updated. Format YYYY-MM-DD HH:MM:SS. UTC timezone.

 

 

  • No labels