venues.show [draft]

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>