PORTA (1.0.0)

Download OpenAPI specification:Download

PORTA team: porta@tui.com License: Apache 2.0

About PORTA

Musement's PORTA (Perfect Open Road To Activities) service allows suppliers to manage their experiences via API.

This is the default security scheme a supplier must use when accessing PORTA in the production environment.

Security Scheme Type: OAuth2

Flow type: clientCredentials

Token URL: https://prod.api.tui/oauth2/token

This is the default security scheme a supplier must use when accessing PORTA in the sandbox environment.

Security Scheme Type: OAuth2

Flow type: clientCredentials

Token URL: https://prod.api.tui/oauth2/token

This security scheme is used by PORTA when calling a supplier's webhook service.

Security Scheme Type: API Key

Header parameter name: x-webhook-key

This section contains a record of changes to the API.

Added vendor_id query parameter to the endpoint GET /supplier/catalog/experiences
- Filters results to those which belong to the specified vendor

Added ticket_numbers and transaction_id properties to booking cancellation request webhook

Changed accept-version header value used for webhook requests
- New value is vnd.porta-webhook-api.v1

Added webhook test endpoints for sandbox environment:
- POST /supplier/integration-tests/book
- POST /supplier/integration-tests/cancel-booking
- POST /supplier/integration-tests/hold

Added endpoint PATCH /supplier/catalog/experiences/{experience_id}
Added archived property to Experience model
- Archived experiences are no longer for sale

Booking confirmation request

Vendors

Added Vendor model
- Used to categorize experiences by different sources, partners or channels
Added two endpoints:
- GET /supplier/vendors
- POST /supplier/vendors
Added vendor_id property to Experience model

Experience model