Resource information
URL | https://api.softnetsport.com/v2/stages |
---|---|
XSD | https://api.softnetsport.com/assets/API/docs/xsd/stages.index.xsd |
Method | GET |
Description | Returns a list of all available stages played in a particular season |
Cache | 60 seconds |
Authorization required | Yes |
Method parameters
Name | Type | Description |
---|---|---|
There are no method parameters in this resource |
Query parameters
Name | Type | Description |
---|---|---|
token | xsd:string | REQUIRED. More information concerning authorization in API introduction section |
lang | xsd:string | Determines language for the output data. The complete list of possible languages can be retrieved using the API resource: languages.index |
page | xsd:int | Determines offset of paginated data. Default value is 1 which means first page |
limit | xsd: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_id | xsd:int | REQUIRED. Determines season to which stages belongs |
timestamp | xsd:unix_timestamp | Selection date, format UNIX_TIMESTAMP. Only changes in stages that occurred or were updated after this timestamp will be returned. |
Method calling examples
Link | Description |
---|---|
https://api.softnetsport.com/v2/stages.xml?token={{YOUR_TOKEN}}&season_id=2212 | Returns the stages played in the season Primera Division 2014/15 in XML format |
https://api.softnetsport.com/v2/stages.xml?token={{YOUR_TOKEN}}&season_id=2212 | Returns the stages played in the season Primera Division 2014/15 in XML format |
Output elements
.competitions | |
---|---|
..competition | |
id | Unique identifier for the competition. The complete list of possible competitions can be retrieved using the API resource: competitions.index |
name | Name of the the competition e.g. U19 World Champ. Possible translation of the attribute |
short_name | Abbreviated name of the competition e.g. U19 WCH, Max 20 characters Possible translation of the attribute |
mini_name | Mini name of the competition. Max 3 characters in length e.g. U19 |
gender | Competition gender. Possible values:
|
type | Competitions type. Possible values:
|
area_id | Unique identifier for area in which competitions are played. The complete list of possible areas can be retrieved using the API resource: areas.index |
area_name | Name of area in which competitions are played. Possible translation of the attribute |
area_type | Type of area in which competitions are played. Possible values:
|
area_sort | The parameter used to sort competitions in a country, e.g. Premier League is 1st and the Championship is 2nd in English competitions. Sorting direction is ascending |
area_code | Max 3 characters in length for the area in which competitions are played |
overall_sort | The parameter used to sort competitions. Sorting direction is ascending |
sport_id | Unique identifier for the sport in which competition is played. The complete list of possible sports can be retrieved using the API resource: sports.index |
sport_name | Name of the sport in which competition is played |
tour_id | Unique identifier for the tour in which competition is played. The complete list of possible tours can be retrieved using the API resource: tours.index |
tour_name | Name of the tour in which competition is played |
ut | Information about the date and time of when the competition record was last updated. Format UNIX_TIMESTAMP |
old_competition_id | deprecated. The attribute will be removed in the next API version |
slug | friendly url for competition |
...seasons | |
....season | |
id | Unique identifier for the season. The complete list of possible seasons can be retrieved using the API resource: seasons.index |
name | Name of the season e.g. Premiership 2014/15 |
year | Determines the season year e.g.
|
ut | Information about the date and time of when the season record was last updated. Format UNIX_TIMESTAMP |
old_season_id | deprecated. The attribute will be removed in the next API version |
....stages | |
.....stage | |
id | Unique identifier for the stage |
name | Name of the stage. Possible translation of the attribute |
start_date | Date when stage begins. Format YYYY-MM-DD |
end_date | Date when stage ends. Format YYYY-MM-DD |
show_standings | Determines if the stage contains standings. Possible values:
|
groups_nr | The number of groups that are part of the stage |
sort | The sort order for the stage. Sorting direction is ascending |
is_current | Possible values:
|
ut | Information about the date and time of when the stage record was last updated. Format UNIX_TIMESTAMP |
old_stage_id | deprecated. The attribute will be removed in the next API version |
......rounds | |
.......round | |
id | Unique identifier for the round |
name | Name of the the round. Possible translation of the attribute |
sort | Order of round. Sorting direction is ascending |
ut | Information about the date and time of when the record was last updated. Format UNIX_TIMESTAMP |