X-Musement-Application header

To better analyze Musement API usage and identify areas of improvement, we have introduced the X-Musement-Application header.

Partners will receive a unique Application value and are expected to include this value for all their API requests. If you currently do not have an Application value, you can request it at api-distribution@tui.com.

Consider the example request below for activities:

Copy
Copied
curl -X GET '{baseUrl}/activities' \
-H 'X-Musement-Version: 3.4.0' \
-H 'Authorization: Bearer {accessToken}'

Using the new X-Musement-Application header, the request becomes:

Copy
Copied
curl -X GET '{baseUrl}/activities' \
-H 'X-Musement-Application: {applicationValue}' \
-H 'X-Musement-Version: 3.4.0' \
-H 'Authorization: Bearer {accessToken}'

The header will also be expected for authentication requests:

Copy
Copied
curl -X POST '{baseUrl}/login' \
-H 'X-Musement-Application: {applicationValue}' \
-H 'X-Musement-Version: 3.4.0' \
-H 'Content-Type: application/json' \
--data-raw '{
	"client_id": "{clientId}",
	"client_secret": "{clientSecret}",
	"grant_type": "{clientCredentials}"
}'

This header is currently optional but there are plans to make it mandatory by the end of June 2022. Partners with existing integrations are expected to add this header as soon as possible.

Copyright © TUI Musement. All rights reserved.