SAP Sailing Analytics Webservices API Version 1.0

URL: /api/v1/trackedRaces/getRaces

Description:

Please note: calling this interface using HTTP GET is deprecated. Use HTTP POST instead. Gets all TrackedRaces found on the local instance, and optionally (depending on the "transitive" parameter) its remote servers. Only those TrackedRaces are contained that are reachable by any Event and have GPS data and a valid startOfRace.

Optionally a list of event UUIDs together with a predicate can be provided. The returned races list will be filtered by the given ids. The predicate specifies the behavior of the filter.

Example: api/v1/trackedRaces/getRaces?transitive=true&events=b1e78f52-ce52-4b71-ac30-452599faf4a1,ee4f04d0-c02c-449c-91cb-606aa5b0480e&pred=incl


Webservice Type: REST
Output format: Json
Mandatory parameters: None
Optional parameters:
  • transitive (true or false; defaults to false) - determines whether the races from other servers referenced remotely shall be collected in the response
  • events: comma separated list of UUIDs depicting an event
  • pred: depicts the semantic of the filtering, when "incl" only races belonging to the depicted event UUIDs are returned. When "excl" is provided the filtering behaves vice versa.
Request method: POST
Example: http://www.sapsailing.com/sailingserver/api/v1/trackedRaces/getRaces

Alternatively the interface can be called using http POST method. The parameters must be then provided within the request body as URL encoded form parameters (see https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/POST).

Webservice Type: REST
Output format: Json
Mandatory parameters: None
Request Content-Type: application/x-www-form-urlencoded
Optional body parameters:
  • transitive (true or false) - determines whether the races from other servers referenced remotely shall be collected in the response
  • events: comma separated list of UUIDs depicting an event
  • pred: depicts the semantic of the filtering, when "incl" only races belonging to the depicted event UUIDs are returned. When "excl" is provided the filtering behaves vice versa.
Request method: POST
Example: http://www.sapsailing.com/sailingserver/api/v1/trackedRaces/getRaces
Back to Web Service Overview