Contact
Overview
Wink API 30.46.0
Section titled “Wink API 30.46.0”Introduction
Welcome to the Wink API - A programmer-friendly way to manage, sell and book travel inventory on the Wink platform. The API gives you all the tools you need to ready your properties and inventory for sale across 1000s of our native sales channels. Integrators, affiliates, travel agents and content creators have the ability to search for your travel inventory and promote / sell it in a wide variety of ways.
Integrations
We have already integrated with the most well-known channel managers so you don’t have to. Once your properties are set up, you can finish the setup by mapping your property to Wink using your channel manager partner portal. If your properties don’t have a channel manager, you can easily manage rates and availability with this API directly.
Intended Audience
Programmers are [most likely] a requirement to start integrating with Wink. Companies and organizations that would most benefit from integrating with us are new and existing travel companies that have relationships with suppliers and that need an advanced system from which to manage their travel inventory and get that same inventory out to as many eyeballs as possible at the lowest price possible.
- Hotel chains
- Hotel brands
- Travel tech companies
- Destination sites
- Integrators
- Aggregators
- Destination management companies
- Travel agencies
- OTAs
How the docs are organized
Not every integrator needs every API, so we group endpoints by audience. Use the group selector at the top of this page to navigate.
- Platform — cross-cutting endpoints used by every integrator: analytics, notifications, managing-entity lookups, payments, reference data, user settings, and a
pingfor credential checks. - Supplier — endpoints for property owners and operators: register a property, manage facilities and experiences, set up monetization (rate plans, promotions, cancellation policies), distribute inventory across sales channels, and reconcile bookings.
- Consumer — endpoints for developers who consume the platform: look up inventory, retrieve specific inventory items, drive checkout and booking, and access the customization engine. Includes a travel-agent surface for agent-facilitated bookings.
- Affiliate — endpoints for resellers and content creators: manage affiliate accounts, browse suppliers and inventory to sell, curate inventory (lists, maps, grids), manage sales channels, and run WinkLinks pages.
- Partner — endpoints for technology partners that integrate at the infrastructure layer (channel managers today; PMS / GDS / OTA partners over time).
Usage
These features are made available to you via a REST API. This API is language agnostic.
Versioning
We chose to version our endpoints in a way that we hope affects your integration minimally. You request the version of our API you wish to work with via the Wink-Version header. When it’s time for you to upgrade, you only have to change the version number to get access to our updated endpoints.
Current version: 2.0
Prior versions: None
Authentication
Section titled “ Authentication ”oauth2ClientCredentials
Section titled “oauth2ClientCredentials ”Retrieve access token
Make a POST (Content-Type: application/x-www-form-urlencoded) request to the Token URL below. Include one POST key/value entry: grant_type=client_credentials and include your clientID / secretKey credentials in a Basic Auth header. E.g. Authorization: Basic base64_encode($clientId + ':' + $secretKey).
Add Bearer access token to all API requests
Once you have the access token, you can pass that along on all API requests in the authentication header: 'Authorization: Bearer $accessToken
Security scheme type: oauth2
Flow type: clientCredentials
Authorization URL: https://iam.wink.travel/oauth2/authorize
Token URL: https://iam.wink.travel/oauth2/token
Refresh URL: https://iam.wink.travel/oauth2/refresh
Scopes:
- integrations.read - View your channel manager integrations.
- integrations.write - Create and update your channel manager integrations.
- integrations.remove - Delete your channel manager integrations.