...
| URL | https://api.softnetsport.com/v2/venues |
|---|---|
| XSD | https://api.softnetsport.com/assets/API/docs/xsd/venues.index.xsd |
| Method | GET |
Description | Returns a list of all available venuesinformation including related sports, possible sports venues details and participants available for the requested venue |
| Cache | 60 seconds |
| Authorization required | Yes |
Method parameters
| Name | Type | Description | There are no method parameters in this resource|
|---|---|---|---|
| venue_id | xsd:int | REQUIRED. The requested venue identifier |
Query parameters
Name | Type | Description | ||
|---|---|---|---|---|
| token | xsd:string | REQUIRED. There is more information concerning authorization in the 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 identifier in which the events are played. Possibility to input multiple identifiers, separated by comma. The complete list of possible sports can be retrieved using the API resource: sports.index | ||
| participant_id | xsd:int | Determines the identifier of the participant. The complete list of possible participants can be retrieved using the API resource: participants.index | ||
| timestamp | xsd:unix_timestamp | Selection date, format UNIX_TIMESTAMP. Only changes in tours that occurred or were updated after this timestamp will be returned. |
Method calling examples
Link | Description |
|---|---|
| https://api.softnetsport.com/v2/venues/1234.xml?token={{YOUR_TOKEN}} | Returns a list of all venues detailed data for the selected venue in XML format |
| https://api.softnetsport.com/v2/venues/1234?token={{YOUR_TOKEN}} | Returns a list of all venues detailed data for the selected venue in JSON format |
Output elements
...
| ..venue | |
|---|---|
| id | Unique identifier for the venue |
| name | Name of the venue |
| ut | Information about the date and time of when the venue record was last updated. Format UNIX_TIMESTAMP |
| ...sports | |
| ....sport | |
| id | Unique identifier for the sport which the venue is related with. The complete list of possible sports can be retrieved using the API resource: sports.index |
| sport_name | Name of the sport which the venue is related with. |
.....venue_sport_details | |
......detail | |
| name | Name of the details. Possible values are different depending on the sport. Possible translation of the attribute |
| value | Value related to the detail |
| ...participants | |
| ....participant | |
| id | Unique identifier of the participant. The complete list of possible participants can be retrieved using the API resource: participants.index |
| name | Participant name. Possible translation of the attribute |
| Code Block | ||
|---|---|---|
| ||
<api ver="2.71" timestamp="1477920772"> <method name="venues.index" details="https://softnet.atlassian.net/wiki/display/APS/venues.indexshow" total_items="1" previous_page="" next_page=""> </method> <data> <venues> <venue id="512" name="Camp Nou" ut="1412929709"> <sports> <sport id="5" name="Soccer"> <venue_sport_details> <detail name="Field size" value="105 m × 68 m (115 yd × 74 yd)"> <detail name="Surface" value="Grass"> <detail name="Scoreboard" value="Yes"> <detail name="Lighting" value="2180 lux"> </venue_sport_details> </sport> <sport id="14" name="Ski jumping"> <venue_sport_details> <detail name="Construction point" value="K120"> <detail name="Man record owner" value="Simon Ammann"> <detail name="Man record value" value="140,5 m"> <detail name="Woman record owner" value=""> <detail name="Woman record value" value=""> </venue_sport_details> </sport> </sports> <participants> <participant id="45" name="FC Barcelona" /> <participant id="557" name="Red Bull Racing" /> </participants> </venue> </venues> </data> </api> |