venues.index [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 a list of all available venues
Cache	60 seconds
Authorization required	Yes

Method parameters

Name	Type	Description
There are no method parameters in this resource

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.xml?token={{YOUR_TOKEN}}	Returns a list of all venues in XML format
https://api.softnetsport.com/v2/venues?token={{YOUR_TOKEN}}	Returns a list of all venues in JSON format

Output elements

.venues
..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.index" total_items="1" previous_page="" next_page="">
		<parameter name="sport_id" value="5"/>
	</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>