Create
const url = 'https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/studio/sales-channel/request';const options = { method: 'POST', headers: { 'Wink-Version': '2.0', Authorization: 'Bearer <token>', 'Content-Type': 'application/json' }, body: 'null'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/studio/sales-channel/request \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'Wink-Version: 2.0' \ --data nullSubmits a new relationship request from the company to a supplier and returns the persisted request once created.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Create property request and associate it with this company identifier
Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69Header Parameters
Section titled “Header Parameters”Request Bodyrequired
Section titled “Request Bodyrequired”Relationship request payload specifying the target supplier and any proposed commission or pricing terms for the new channel partnership
A request for relationship between two parties.
object
Type of relationship request
Example
DIRECT_CONNECTIONSupplier identifier the relationship request targets
Example
e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18Introductory message from the requester explaining the purpose of the connection request.
Example
We are interested in partnering with your property to offer discounted rates to our clientele.Example
{ "requestType": "DIRECT_CONNECTION", "supplierIdentifier": "e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18", "introductoryMessage": "We are interested in partnering with your property to offer discounted rates to our clientele."}Responses
Section titled “Responses”Sales channel relationship request successfully created
A request for relationship between two parties.
object
Unique identifier for this record.
Datetime this record was first created
Datetime this record was last updated
Optimistic-locking version. Echo this value back as an If-Match request header on a conditional update; the server responds 409 if the record changed in the meantime. Null when this projection has no backing versioned document, in which case no conditional update is possible.
Status of the relationship request
Type of relationship request
Supplier identifier receiving this relationship request
Name of the property/supplier receiving the request
Type of entity initiating the relationship request
Unique identifier of the owner/affiliate initiating the request
Name of the owner/affiliate initiating the request
Message from requester explaining the purpose and benefits of the proposed relationship
Example
Bad Request — missing or invalid request parameter or body
object
object
Example
Unauthorized — authentication is required or the session has expired
object
object
Example
Forbidden — authenticated but lacking the required permission or scope
object
object
Example
Not Found — the requested resource does not exist
object
object
Example
Method Not Allowed — the HTTP verb is not supported on this endpoint
object
object
Example
Conflict — the resource was modified by someone else since you read it; re-read it and retry with the new version
object
object
Example
Unsupported Media Type — use application/json
object
object
Example
Internal Server Error — an unexpected failure occurred on the server
object
object
Example
Service Unavailable — a downstream dependency is unreachable