Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

Resource information

URLhttps://api.softnetsport.com/v2/venues{venue_id}
XSDhttps://api.softnetsport.com/assets/API/docs/xsd/venues.show.xsd
MethodGET

Description

Returns information including related sports, possible sports venues details and participants available for the requested venue
Cache60 seconds
Authorization requiredYes

Method parameters

NameTypeDescription
venue_idxsd:intREQUIRED. The requested venue identifier

Query parameters

Name
Type
Description
tokenxsd:stringREQUIRED. There is more information concerning authorization in the API introduction section
langxsd: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
idUnique identifier for the venue
nameName of the venue
utInformation about the date and time of when the venue record was last updated. Format UNIX_TIMESTAMP
..sports
...sport
idUnique 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_nameName of the sport which the venue is related with.

....venue_sport_details


.....detail


nameName of the details. Possible values are different depending on the sport. Possible translation of the attribute
valueValue related to the detail
..participants
...participant
idUnique identifier of the participant. The complete list of possible participants can be retrieved using the API resource: participants.index
nameParticipant 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>
  • No labels