ST OpenData API Release Notes

All notable changes to the ST OpenData API will be documented here.

v1.3.8 2024-09-03

Changed

• fix a bug that caused the 'subtrip' query parameter to be ignored on the /tours endpoint
• fix the /tours/.../geodata endpoint not returning data for cross-country-skiing, snowshoe-trekking and winter-hiking

v1.3.7 2024-08-23

Changed

• Fix the tours/.../geodata endpoint to only return relevant GeoJSON data for a given tour

v1.3.6 2024-06-07

Added

• add new property 'recommendedSeason' for attractions

v1.3.5 2024-03-08

Added

• add support for serving GeoJSON features for tourist trip stages

Changed

• Fix a bug that caused a server error when trying to fetch large GeoJSON features

v1.3.4 2024-02-16

Added

• new endpoint for geographical data in GeoJSON format for selected tourist trips

Changed

• Fix duplicate object IDs in 'self' references

v1.3.3 2023-05-26

Added

• List endpoints now support new query parameter 'top' (boolean) for filtering 'top' touristic objects

v1.3.2 2022-11-25

Added

• add new 'origin' of content property to tourist trips
• new facet 'origin' for filtering tourist trip origins

v1.3.1 2022-09-16

Added

• the tourist trip itinerary now contains additional 'via' places

Changed

• documentation of the 'language' query parameter corrected (language code is actually ISO 639-1)

v1.3.0 2022-08-12

Added

• the API now provides data for tourist trips (/tours)

Changed

• the specification schema for Adress.url and Person.image has been corrected (url -> uri)

v1.2.2 2022-07-01

Added

• The API now supports a new boolean query parameter 'striphtml'. If set to 'true', all html code will be removed in abstracts and descriptions

v1.2.1 2021-09-17

Added

• the API now returns ETag and Last-Modified headers

v1.2.0 2021-04-08

Added

• the API now provides data for touristic offerings (/offers)
• add PriceSpecification to the list of schemas returned by the API
• add missing @context property in the GeoCoordinates schema

Changed

• fix encoding for asset metadata: some assets where using WTF-8 for their metadata encoding (e.g. for keywords). The API now consistently returns UTF-8.
• the identifier and name properties on the Address schema are now optional
• fix the path in the containedInPlace URLs for attractions and destinations as these where pointing to a non-existing API path before

v1.1.1 2021-02-11

Added

• operations returning a list of items now support a new 'expand' boolean query parameter. If set to true, the API will return the full set of data for each item instead of just a limited subset of the object's properties
• add schema definitions for response errors

Changed

• fix the property type for various 'integer' values (eg. used for paging) which where previously declared as 'number' (float).
• calling the API without a valid API key will now result in HTTP status 401 ("unauthorized") instead of 403 ("forbidden")

v1.1.0 2020-09-03

Added

• Translation of facet names and values
  By setting the query parameter facets.translate boolean parameter to true, facet translations are added as a new facetTranslations object in the meta-data section of the API's response.
  See the API documentation for more information about this feature

Changed

• the facet.filter query parameter for lists now supports the '*' wildcard

v1.0.4 2020-08-13

Added

• The OpenData API documentation now contains a pointer to the API Release Notes

v1.0.3 - 2020-07-21

Added

• image data (@type: ImageObject) now also provides copyrightHolder, creator, publisher, width and height properties

Changed

• the keywords property on ImageObject now contains additional keywords that where previously unavailable

v1.0.2 - 2020-06-23

Changed

• minor tweaks to the API description

v1.0.1 - 2020-06-30

Changed

• fix broken markdown in the API documentation
• correct examples explaining the facet.filter query parameter

v1.0.0 - 2020-04-29

• Initial public release