Gå til indhold

Kom godt i gang

Denne guide tager dig fra ingenting til en fungerende integration på cirka 30 minutter. Når du er færdig, vil du have:

  • live priser på hoteller i en by, fra Partner API,
  • et bookingslink, der krediterer bookinger til din konto,
  • en testbooking og en webhook, der fortæller dig, at den er sket.

Alt foregår i staging, vores testmiljø. Du behøver ikke bede os om adgang, og det kræver heller ikke godkendelse at gå i produktion senere.

Du vil…Start her
Vise hoteller i din app, på dit site eller i dit AI-produkt og sende rejsende til booking, så du tjener kommissionDenne guide
Booke på vegne af dine kunder som et autoriseret rejsebureauDenne guide op til trin 5, derefter Booking som rejsebureau
Indlejre bookbare hoteller uden at skrive en integrationWeb Components
Lade en AI-agent søge og bookeMCP Servers og Agentic Payments
Tilkoble en channel manager eller PMSTilføj din channel manager

Du bruger Partner API til at finde hoteller og deres live priser. Hvert hotel har et stabilt urlName. Du laver det om til et link til Wink Booking Engine, book.wink.travel, som bærer dine ID’er. Den rejsende booker og betaler der, og bookingen krediteres din konto.

Du skal bruge:

  • grpcurl, eller Postman eller Insomnia. Partner API er gRPC, ikke REST.
  • curl.

Staging er helt adskilt fra produktion med egne login og konti.

  1. Gå til staging-app.wink.travel, klik på Sign-In / Register og registrer dig.

  2. Klik på Accounts i venstre sidebjælke, derefter Create, og vælg I am an Affiliate. Bookinger, du sender, krediteres denne konto. Se Opret konto.

Applikationen giver din kode sine legitimationsoplysninger.

  1. På dit kontokort klikker du Actions > Manage account, og derefter fanen Applications.

  2. Klik Create new application, giv den et navn og vælg Machine-to-machine som klienttype.

  3. Under scopes vælger du Inventory & rates (read). Partner API tjekker for inventory.read.

  4. Klik Create application og kopier Client ID og Client secret. Secret vises én gang og kan ikke hentes igen.

Se Applications for de andre klienttyper og scopes.

Terminal window
curl -X POST https://staging-iam.wink.travel/oauth2/token \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials" \
-d "client_id=<YOUR_CLIENT_ID>" \
-d "client_secret=<YOUR_CLIENT_SECRET>" \
-d "scope=inventory.read"

Gem access_token fra svaret:

Terminal window
export WINK_TOKEN=<access_token>

Tokens udløber. I din egen kode skal du lade et OAuth2-bibliotek hente og opdatere dem. Se Authentication.

Hvis token-forespørgslen afvises, er svaret en JSON-body med en error-kode:

errorHTTP-statusAlmindelig årsag
invalid_client401Forkert client ID eller secret, eller produktions-legitimationsoplysninger brugt på staging-iam
invalid_scope400Forespørgslen beder om et scope, som applikationen ikke er registreret til
unauthorized_client400Applikationen har ikke tilladelse til at bruge client_credentials grant
invalid_request400En påkrævet parameter mangler, for eksempel når body er JSON i stedet for en form

Hvert Partner API-kald navngiver den konto, du handler for, i en managing-entity-id header. List de konti, dit token kan handle for:

Terminal window
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
-d '{}' \
staging-partner.wink.travel:443 wink.partner.v1.Accounts/ListAccounts

Kopier accountId for affiliate-kontoen fra trin 1:

Terminal window
export WINK_ACCOUNT_ID=<accountId>

Staging har testhoteller med tilgængelighed i Bangkok, så denne søgning bruger dens slug, bangkok-thailand:

Terminal window
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
-H "managing-entity-id: $WINK_ACCOUNT_ID" \
-d '{
"urlName": "bangkok-thailand",
"userSession": {
"itinerary": {
"startDate": "2026-12-01",
"nights": 2,
"room": { "adults": 2 }
},
"currencyCode": "USD",
"languageCode": "en"
}
}' \
staging-partner.wink.travel:443 wink.partner.v1.Search/SearchByCity

Brug en check-in dato i fremtiden; en tidligere dato afvises. Hvert resultat indeholder:

  • name, starRating og heroImageUrl, nok til at vise en resultatlinje,
  • roomTypes, de live tilbud, billigste værelse først,
  • urlName, den slug du skal bruge til bookingslinket.

Priser er heltal i mindreenheder: divider med 10 opløftet til currencyExponent fra svaret (2 for USD, så 12500 er $125,00).

Kender du ikke en bys slug? Find den med wink.partner.v1.Lookup/Search. For en ejendoms fulde indhold, brug Content-servicen. Partner API-referencen dokumenterer alle kald.

https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID>
  • <urlName> er hotellets urlName fra trin 5.
  • client-id er din applikations Client ID fra trin 2.
  • configuration-id er dit tilpasnings-ID: Manage account > Customizations. En tilpasning sætter også dit branding, standardsprog og valuta på bookingsiden.

Tilføj den rejsendes datoer, gæster, sprog og valuta til samme link, så hotelsiden åbner med dem udfyldt:

https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID>&sd=2027-03-14&n=2&rc=a2&l=en&c=USD
ParameterBetydningEksempel
sdCheck-in datosd=2027-03-14
n eller edAntal nætter eller check-out daton=2 eller ed=2027-03-16
rcGæster pr. værelserc=a2 (2 voksne)
lVisningssprogl=en
cVisningsvalutac=USD
pKampagnekodep=ABC123

Disse parametre overskriver standarderne sat i din tilpasning. Guiden til Book Now-knappen dækker det fulde rc-format, inklusive børn og flere værelser.

Linket åbner hotelsiden; det kan ikke forudvælge et værelse eller en pris. Den rejsende vælger værelset på hotelsiden til live-prisen.

Se Direkte linking for at linke til bookingengineens startside i stedet for et enkelt hotel.

Åbn dit link, vælg datoer og et værelse, og betal med et Stripe testkort, for eksempel 4242 4242 4242 4242 med en hvilken som helst fremtidig udløbsdato og CVC. Ingen rigtige kort bliver trukket i staging. Bemærk bookingkoden på bekræftelsessiden; den starter med WNK.

  1. I Portal, gå til Applications > Webhooks og tilføj et endpoint, der accepterer POST-anmodninger.

  2. Abonner på booking.create, eller lad begivenhedslisten være tom for at modtage alt, mens du udvikler.

  3. Send dig selv en testbegivenhed, lav en ny testbooking og se den komme frem.

Verificer hver leverings signatur, før du stoler på den. Se Webhook Integration og Webhook Events Catalog.

Der er ingen godkendelsesproces for udviklere. (Rejsebureaukonti certificeres først; se nedenfor.) Når din integration virker i staging:

  1. Opret en konto og en applikation på app.wink.travel, som i trin 1 og 2. Legitimationsoplysninger overføres ikke mellem miljøer.

  2. Fjern staging- fra alle hosts:

    StagingProduktion
    https://staging-iam.wink.travelhttps://iam.wink.travel
    staging-partner.wink.travel:443partner.wink.travel:443
    https://staging-book.wink.travelhttps://book.wink.travel
  3. Find dit produktionskonto-ID (trin 4) og tilpasnings-ID (trin 6) igen. De er forskellige fra staging.

Partner API-brug måles i hotel-nætter med en gratis månedlig kvote. Se Partner API for priser og grænser.

Hvis din konto er et autoriseret rejsebureau, behøver du ikke sende rejsende til book.wink.travel: du kan oprette bookinger direkte med wink.partner.v1.Booking/CreateBooking og administrere dem med de andre Booking-kald. Andre konti sender rejsende til bookingslinket i stedet.

Rejsebureaukonti certificeres: Wink gennemgår hver bureaus registrering, før det kan booke. Bureauer, der ønsker at opkræve betaling direkte fra deres kunder som merchant of record, skal booke gennem Partner API og have Winks skriftlige godkendelse. Se Kom godt i gang som rejsebureau og Partner API-referencen.