Resource information
| URL | https://api.softnetsport.com/v2/seasons |
|---|---|
| XSD | https://api.softnetsport.com/assets/API/docs/xsd/seasons.index.xsd |
| Method | GET |
Description | Returns the seasons played in the competitions |
| Package | This resource is included in the STATISTICS packages |
| Authorization required | Yes |
Method parameters
| Name | Type | Description |
|---|---|---|
| There are not method parameters in this resource | ||
Query parameters
| Name | Type | Description |
|---|---|---|
| token | xsd:string | REQUIRED. More information concerning oAuth token: oAuth 2.0 authorization |
| lang | xsd:string | Determines language for the output data. softnetSPORT API provides the following languages: 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 |
| sport_id | xsd:int | Determines sport to which season belongs. softnetSPORT API provides the following sports: sports.index |
| competition_id | xsd:int | Determines competition to which competition belongs. softnetSPORT API provides the following competitions: competitions.index |
| year | xsd:string | Determines the season year f.e:
|
| area_id | xsd:int | Determines the area represented by the participant. softnetSPORT API provides the following areas: areas.index |
| timestamp | timestampxsd:unix_timestamp | Selection date, format UNIX_TIMESTAMP. Only changes in seasons which occured or was updated after this timestamp will be returned. |
Method calling examples
Link | Description |
|---|---|
| https://api.softnetsport.com/v2/seasons.xml?token={{YOUR_TOKEN}} | Returns the list of seasons names in XML format |
| https://api.softnetsport.com/v2/seasons?token={{YOUR_TOKEN}} | Returns the list of seasons names in JSON format |
| https://api.softnetsport.com/v2/seasons.xml?token={{YOUR_TOKEN}}&competition_id=1507 | Returns the seasons played in the competition - Primera Division |
| https://api.softnetsport.com/v2/seasons.xml?token={{YOUR_TOKEN}}&sport_id=5 | Returns the all competitions seasons played in soccer |
| https://api.softnetsport.com/v2/seasons.xml?token={{YOUR_TOKEN}}&year=2014/15 | Returns the all competitions seasons played in the season year 2014/15. |
Output elements
.competitions | |
|---|---|
..competition | |
| id | Unique identifier for the competition |
| name | Name of the the competition i.e.: U19 World Champ |
| short_name | Shorter name of the competition i.e.: U19 WCH, Max 20 characters |
| mini_name | Mini name of the competition. Max 3 characters length i.e.: U19 |
| gender | Competition gender. Possible values:
|
| type | Competitions type. Possible values:
|
| area_id | Unique identifier of area in which competitions are played. softnetSPORT API provides the following areas: areas.index |
| area_name | Name of area in which competitions are played |
| area_type | Type of area in which competitions are played. Possible values:
|
| area_sort | The 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 ascending |
| area_code | Max 3 characters length of area in which competitions are played |
| overall_sort | The parameter used to sort competitions. Sorting direction is ascending |
| sport_id | Unique identifier of the sport in which competition is played. softnetSPORT API provides the following sports: sports.index |
| sport_name | Name of the sport in which competition is played |
| tour_id | Unique identifier of the tour in which competition is played. softnetSPORT API provides the following tours: tours.index |
| tour_name | Name of the tour in which competition is played |
| ut | Information about date and time when the competition record was last updated. Format UNIX_TIMESTAMP |
| old_competition_id | deprecated. The attribute will be removed in the next API version |
...seasons | |
....season | |
| id | Unique identifier for the season |
| name | Name of the season f.e: Premiership 2014/15 |
| year | Determines the season year f.e:
|
| ut | Information about date and time when the season record was last updated. Format UNIX_TIMESTAMP |
| old_season_id | deprecated. The attribute will be removed in the next API version |