Resource information
softnetsport the | a list of all available seasons played in the competitions |
Package | This resource is included in STATISTICS packages |
| Cache | 60 seconds |
|---|
| Authorization required | Yes |
|---|
Method parameters
| Name | Type | Description |
|---|
| There are |
not | no method parameters in this resource |
Query parameters
| Name | Type | Description |
|---|
| token | xsd:string | REQUIRED. |
More | More information concerning |
oAuth token: oAuth 2.0 authorization | authorization in API introduction section |
| lang | xsd: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
|
| 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 the sport to which the season belongs. |
softnetSPORT API provides the following sports| The complete list of possible sports can be retrieved using the API resource: sports.index |
| competition_id | xsd:int | Determines the competition to which |
competition belongs. softnetSPORT API provides the following competitions: competitions.indexthe season belongs. Possibility to input multiple identifiers, separated by comma. The complete list of possible competitions can be retrieved using the API resource: competitions.index
|
| participant_id | xsd:int | Determines the participant that is included in the seasons. The complete list of possible participants can be retrieved using the API resource: participants.index |
| multi_ids | xsd:string | List of season identifiers separated by a comma (e.g. 123,234,321) for the season details you want to get.(Up to 100 ids) |
| year | xsd:string | Determines the season year |
fe:- 1970
- 1970/71
- 1971
- 1971/72
- 2000
- 2000/01
- 2014
- 2014/15
|
| sort_type | xsd:string | Determines sort order of data. Possible values: - competitions - competitions are sorted by overall_sort
- seasons - seasons are sorted by year
|
| sort_order | xsd:string | Additional parameter for sort_type which determines the direction of sort (ascending, descending)
By default the value of "desc" is set. Possible values: - asc - sort ascending
- desc - sort descending
|
| area_id | xsd:int | Determines the area represented by the participant. |
softnetSPORT API provides the following areas: The complete list of possible areas can be retrieved using the API resource: areas.index |
type:stringParticipant type. Possible valuestimestamp | timestampxsd:| unix_timestamp | Selection date, format UNIX_TIMESTAMP. Only changes in the seasons |
which occured was | were updated after this timestamp will be returned. |
Method calling examples
softnetsport.xmlusername=softnetsport the list of seasons names in XML format| https://api.softnetsport.com/v2/seasons?username=softnetsport | Returns the list of seasons softnetsport.xmlusername=softnetsportsoftnetsport.xmlusername=softnetsport the competitions softnetsport.xmlusername=softnetsport the competitions | competition seasons played in the season year 2014/15. |
Output elements
.| | .. | | 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: - 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_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 |
| |
|---|
| |
|---|
| id | Unique identifier for the season |
| name | Name of the season f.e: Premiership 2014/15 |
| year | Determines the season year f.e: - 1970
- 1970/71
- 1971
- 1971/72
- 2000
- 2000/01
- 2014
- 2014/15
|
| 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 |
...
| Include Page |
|---|
| Competition node |
|---|
| Competition node |
|---|
|
|
|
|---|
|
|---|
|