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
username Assigned to you by softnetSPORT administrator 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 |
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: |
timestamp | timestampxsd- 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. The complete list of possible areas can be retrieved using the API resource: areas.index |
timestamp | xsd: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 seasons XML formathttps://api.softnetsport.com/v2/seasons?username=softnetsport | Returns the list of seasons names in 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 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 |
comp_id | Identifier of the competition. softnetSPORT API provides the following competitions: competitions.index |
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 |
---|
|
|
|
---|
|
---|
|