Resource information
URL | https://api.softnetsport.com/v2/venues |
---|---|
XSD | https://api.softnetsport.com/assets/API/docs/xsd/venues.index.xsd |
Method | GET |
Description | Returns information 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 |
---|---|---|
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 |
Method calling examples
Link | Description |
---|---|
https://api.softnetsport.com/v2/venues/1234.xml?token={{YOUR_TOKEN}} | Returns detailed data for the selected venue in XML format |
https://api.softnetsport.com/v2/venues/1234?token={{YOUR_TOKEN}} | Returns 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 |
<api ver="2.71" timestamp="1477920772"> <method name="venues.index" details="https://softnet.atlassian.net/wiki/display/APS/venues.show" total_items="1" previous_page="" next_page=""> </method> <data> <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> </data> </api>