How to work with the profile service¶
- All data in the profile service is personal data which is protected and only accessible in the name of a user. Or in other words: with an identification-level of the session or device.
- Data of registered users is only accessible with a valid authorization token of the user.
See (How-to get access to the api).
Some user data is shared between all partners:
Other is automatically connected and restricted to the partner (solution provider's subscription) itself:
- partner data
The user can see all his/her data in the myData portal.
The subscription key (api management) is related to a user in Api Management and this User is related to the partner. Therefore you do not necessarily get the same results with different subscription keys. But we can configure several users and subscriptions for the same partner.
The profile service is storing all data related to a user (profile/device/session).
General information to the person. This is used as the "customer" in an order.
Groups of travelers
- PartnerData Generic data store to save any data you need in the user's profile. There can be several of them per profile. The idea is that you give them the same name for each user. for example "favorites", "xmas-quiz-2020", ...
All orders booked with this profile (only get).
- Tickets All tickets bought with this profile (only get).
- ProfileMedia All images related to this profile.
There is not much special on the endpoints. Check out the profile service reference.
For B2C orders. First you need to get Token and create a profile. For more details see profile service reference.
For creating orders and tickets see How to work with the marketplace
Language: Profile data is not available in all languages, it is stored in the current language of the request. So for example product names in old orders won't change if you change the language of the request to get them.
DateTime formatting: "2019-08-09T13:59:57.097+02:00"
The default timezone is UTC
Number formatting: CH -> 250.00
All relevant events related to the user we write in a log. We call it "Business Trail" to not be confused with "audit trail" which is usually used to track all data-changes on a technical data level.
The business trail is meant for the support and maybe we can work with the data in the future as well. It is personal data and we do not write any data in the regular server logs which could be personally relevant.
Because many of such events will happen on client side, you are invited to add your own events there.
The data you write and all entries which are written based on a request coming from you, will be related to the partner like other partner data (see above).
- For more information see Profile service endpoints.
- Technical definitions of each API, sample code, test UI and Open API definitions to download you can find in the developer portal.