Versions Compared

Old Version 13

changes.mady.by.user FormerUser1

Saved on

compared with

New Version Current

changes.mady.by.user Adam Kotwicki

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Resource information

URLhttps://api.
softnetsport
statscore.com/v2/stages
MethodGET

Description

Returns
the
a list of all available stages played in
the seasonsPackageThis resource is included in STATISTICS package
a particular season
Cache60 seconds
Authorization requiredYes

Method parameters

NameTypeDescription
There are
not
no method parameters in this resource 

Query parameters

NameTypeDescription
username
tokenxsd:stringREQUIRED.
Assigned to you by softnetSPORT administrator
 More information concerning authorization in API introduction section
langxsd:string

Determines language for the output data.

softnetSPORT API provides the following languages

The complete list of possible languages can be retrieved using the API resource: languages.index

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

season_idxsd:
string
intREQUIRED. Determines season to which stages belongs
. softnetSPORT API provides the following seasons: seasons.index
timestampxsd:unix_timestampSelection date, format UNIX_TIMESTAMP. Only changes in stages
which occured
that occurred or
was
were updated after this timestamp will be returned.

Method calling examples

Link
Description
https://api.
softnetsport
statscore.com/v2/stages
.xml
?
username=softnetsport&season_id=2212Returns the stages played in the season Primera Division 2014/15 in XML formathttps://api.softnetsport.com/v2/stages.xml?username=softnetsport
token={{YOUR_TOKEN}}&season_id=2212Returns the stages played in the season Primera Division 2014/15
in XML format

Output elements

...


.
competition
 idUnique identifier for the competitionnameName of the the competition i.e.: U19 World Champshort_nameShorter name of the competition i.e.: U19 WCH, Max 20 charactersmini_name

Mini name of the competition. Max 3 characters length i.e.: U19

gender

Competition gender. Possible values:

  • male
  • female
  • mixed
  • undefined
type

Competitions type. Possible values:

  • 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.indexarea_nameName of area in which competitions are playedarea_type

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

  • country
  • international
area_sortThe parameter used to sort competitions in the country, i.e. Premier League is 1st and the Championship is 2nd in English competitions. Sorting direction is ascendingarea_codeMax 3 characters length of area in which competitions are playedoverall_sortThe parameter used to sort competitions. Sorting direction is ascending
sport_idUnique identifier of the sport in which competition is played. softnetSPORT API provides the following sports: sports.indexsport_nameName of the sport in which competition is playedtour_idUnique identifier of the tour in which competition is played. softnetSPORT API provides the following tours: tours.indextour_nameName of the tour in which competition is playedutInformation about date and time when the competition record was last updated. Format UNIX_TIMESTAMPold_competition_iddeprecated. The attribute will be removed in the next API version
..season
 idUnique identifier for the seasonnameName of the season f.e: Premiership 2014/15comp_idIdentifier of the competition. softnetSPORT API provides the following competitions: competitions.indexyear

Determines the season year f.e:

  • 1970
  • 1970/71
  • 1971
  • 1971/72
  • 2000
  • 2000/01
  • 2014
  • 2014/15
utInformation about date and time when the season record was last updated. Format UNIX_TIMESTAMPold_season_iddeprecated. The attribute will be removed in the next API version
...stages
 
....stage
 idUnique identifier for the stagenameName of the stagestart_dateDate when stage begins. Format YYYY-MM-DDend_dateDate when stage ends. Format YYYY-MM-DDseason_idUnique identifier for the season to which stage belongs
show_standings

Determines if the stage contains a standings. Possible values:

  • yes
  • no
groups_nrThe amount of groups that are part of the stagesortThe sort order for the stage. Sorting direction is ascendingis_current

Possible values:

  • yes
  • no
utInformation about date and time when the stage record was last updated. Format UNIX_TIMESTAMPold_stage_iddeprecated. The attribute will be removed in the next API version

 

...

Include Page
Competition node
Competition node

competition > season

Include Page
Season node
Season node

competition > season > stages
competition > season > stages > stage

Include Page
Stage node
Stage node