Development documentation¶
Learn how to build powerful applications to serve the Swiss Tourism using discover.swiss services. Get documentation, example code, tutorials, and more.
Tip
Our newest work, releases, coming soon and known bugs you can find in the Devops section of this documentation.
documentation in progress
We constantly work to improve our documentation. What you can find here is not wrong, but not fully complete and some diagrams might be a bit outdated.
If you have any questions or remarks we are happy to get your feedback at support@discover.swiss.
Overview¶
We build a knowledge graph which contains all object and relations which are relevant to build applications for the swiss tourism industry. It is not just a static graph of data we want it to become as lively as possible and provide real time information, communication, reservations and bookings whenever possible. To achieve this we collect and merge data and functinalities from existing best of breed offerings and make everything available in a consistent way.
Domains¶
The domains we address are
Infocenter (knowledge graph)¶
Information about places, tours, events, weather, webcams, ... all linked and consistent. For each (for us interesting) thing in the real world there is exactly 1 representation in our "digital twin of Swiss Tourism"
Profile / myData¶
Everything about the user and the guest. Just as with things we aim towards haveing each real person represented excactly 1 time in our digital world
Marketplace¶
Bookings, reservations, payment service and everything needed for it.
B2B Marketplace¶
Bookings, reservations, payment service for partners.
Identity provider¶
For all user authentication we maintain an Azure Active directory B2C instance to provide authentication and identity.
Products¶
API services¶
The main way to get access to our services is using our API. We provide
- REST api delivering data in schema.org and json-ld formatting
- Azure Search for sophisticated and personalized search
- Graph QL for modern access to all functionalities joined across all domains (coming soon)
- Developer portal to access subscription keys and api definition (OpenAPI) developer.discover.swiss
Azure Active Directory B2C¶
Microsoft provides plug-ins, libraries and webpages to support login and other user flows. We offer configuration and individual flow design for every frontend partner.
my.discover.swiss Portal¶
This is designed for the enduser to access all his profile data to fulfil GDPR and myData concepts. The data belongs to the enduser and the enduser is in control of it.
Partner Portal¶
This is the administration portal for our partners to access
- their own infocenter data
- billing and booking information
- enduser data they are allowed to access
- statistics
Demo Portal¶
A simple demo portal to test and show our functionalities. It is using only the test environment and is not intended to use for production or anything else than providing a sample. "You must know how to use it" and it is constantly work in progress.
Web components¶
We offer web components to make it easier to display complex data and processes:
- checkout component (Shoppingbasket including product configuration and checkout) which works with our marketplace B2C service. (Checkout the example on the Demo Portal)
- infocenter landing web-component to easily display a filterable list of infocenter objects on your website (Checkout the example on the Demo Portal)