Hoppa till innehåll

Kom igång snabbt

Den här guiden tar dig från ingenting till en fungerande integration på cirka 30 minuter. I slutet kommer du att ha:

  • livepriser för hotell i en stad, från Partner API,
  • en bokningslänk som krediterar bokningar till ditt konto,
  • en testbokning och en webhook som meddelar att den har skett.

Allt sker i staging, vår testmiljö. Du behöver inte be oss om åtkomst, och att gå till produktion senare kräver heller inget godkännande.

Du vill…Börja här
Visa hotell i din app, webbplats eller AI-produkt och skicka resenärer för att boka, och tjäna provisionDen här guiden
Boka åt dina kunder som en licensierad resebyråDen här guiden upp till Steg 5, sedan Boka som resebyrå
Bädda in bokningsbara hotell utan att skriva en integrationWeb Components
Låta en AI-agent söka och bokaMCP Servers och Agentic Payments
Koppla en channel manager eller PMSLägg till din channel manager

Du använder Partner API för att hitta hotell och deras livepriser. Varje hotell har ett stabilt urlName. Du gör det till en länk till Wink Booking Engine, book.wink.travel, som bär dina ID:n. Resenären bokar och betalar där, och bokningen krediteras ditt konto.

Du behöver:

  • grpcurl, eller Postman eller Insomnia. Partner API är gRPC, inte REST.
  • curl.

Staging är helt separat från produktion, med egna inloggningar och konton.

  1. Gå till staging-app.wink.travel, klicka på Sign-In / Register och registrera dig.

  2. Klicka på Accounts i vänstra sidomenyn, sedan Create, och välj I am an Affiliate. Bokningar du skickar krediteras detta konto. Se Skapa konto.

Applikationen ger din kod dess behörigheter.

  1. På ditt kontokort, klicka Actions > Manage account, sedan fliken Applications.

  2. Klicka Create new application, ge den ett namn och välj Machine-to-machine som klienttyp.

  3. Under scopes, välj Inventory & rates (read). Partner API kontrollerar för inventory.read.

  4. Klicka Create application och kopiera Client ID och Client secret. Hemligheten visas en gång och kan inte hämtas senare.

Se Applications för andra klienttyper och 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"

Spara access_token från svaret:

Terminal window
export WINK_TOKEN=<access_token>

Tokens går ut. I din egen kod, låt ett OAuth2-bibliotek hämta och uppdatera dem. Se Authentication.

Om tokenförfrågan avvisas är svaret en JSON-kropp med en error-kod:

errorHTTP-statusVanlig orsak
invalid_client401Fel client ID eller secret, eller produktionsbehörigheter använda på staging-iam
invalid_scope400Förfrågan ber om ett scope som applikationen inte är registrerad för
unauthorized_client400Applikationen har inte tillåtelse att använda client_credentials-grant
invalid_request400En obligatorisk parameter saknas, till exempel när kroppen är JSON istället för ett formulär

Varje Partner API-anrop anger kontot du agerar för i en managing-entity-id-header. Lista de konton din token kan agera för:

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

Kopiera accountId för affiliate-kontot från Steg 1:

Terminal window
export WINK_ACCOUNT_ID=<accountId>

Staging har testhotell med tillgänglighet i Bangkok, så denna sökning använder dess 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

Använd ett incheckningsdatum i framtiden; ett tidigare datum avvisas. Varje resultat innehåller:

  • name, starRating och heroImageUrl, tillräckligt för att visa en resultatrad,
  • roomTypes, de liveerbjudanden, billigaste rum först,
  • urlName, sluggen du behöver för bokningslänken.

Priser är heltal i mindre enheter: dela med 10 upphöjt till currencyExponent från svaret (2 för USD, så 12500 är $125,00).

Vet du inte en stads slug? Hämta den med wink.partner.v1.Lookup/Search. För en fastighets fullständiga innehåll, använd Content-tjänsten. Partner API-referensen dokumenterar varje anrop.

https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID>
  • <urlName> är hotellets urlName från Steg 5.
  • client-id är din applikations Client ID från Steg 2.
  • configuration-id är din anpassnings-ID: Manage account > Customizations. En anpassning ställer också in din branding, standardspråk och valuta på bokningssidan.

Lägg till resenärens datum, gäster, språk och valuta i samma länk så att hotelsidan öppnas med dessa ifyllda:

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
ParameterBetydelseExempel
sdIncheckningsdatumsd=2027-03-14
n eller edAntal nätter, eller utcheckningsdatumn=2 eller ed=2027-03-16
rcGäster per rumrc=a2 (2 vuxna)
lVisningsspråkl=en
cVisningsvalutac=USD
pKampanjkodp=ABC123

Dessa parametrar åsidosätter standardinställningarna i din anpassning. Guiden för Book Now-knappen täcker hela rc-formatet, inklusive barn och flera rum.

Länken öppnar hotelsidan; den kan inte förvalda ett rum eller ett pris. Resenären väljer rum på hotelsidan, till livepriset.

Se Länka direkt för att länka till bokningsmotorns startsida istället för ett enskilt hotell.

Öppna din länk, välj datum och rum, och betala med ett Stripe testkort, till exempel 4242 4242 4242 4242 med vilket framtida utgångsdatum och valfri CVC. Inget riktigt kort debiteras i staging. Notera bokningskoden på bekräftelsesidan; den börjar med WNK.

  1. I Portal, gå till Applications > Webhooks och lägg till en endpoint som accepterar POST-förfrågningar.

  2. Prenumerera på booking.create, eller lämna händelselistan tom för att ta emot allt medan du utvecklar.

  3. Skicka ett testevent till dig själv, gör sedan en ny testbokning och se att det kommer fram.

Verifiera varje leverans signatur innan du litar på den. Se Webhook Integration och Webhook Events Catalog.

Det finns inget godkännandesteg för utvecklare. (Resebyråkonto certifieras först; se nedan.) När din integration fungerar i staging:

  1. Skapa ett konto och en applikation på app.wink.travel, som i Steg 1 och 2. Behörigheter överförs inte mellan miljöer.

  2. Ta bort staging- från varje host:

    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. Hämta ditt produktionskonto-ID (Steg 4) och anpassnings-ID (Steg 6) igen. De skiljer sig från staging.

Partner API-användning mäts i hotellnätter, med en gratis månadsgräns. Se Partner API för priser och begränsningar.

Om ditt konto är en licensierad resebyrå behöver du inte skicka resenärer till book.wink.travel: du kan skapa bokningar direkt med wink.partner.v1.Booking/CreateBooking och hantera dem med de andra Booking-anropen. Andra konton skickar resenärer till bokningslänken istället.

Resebyråkonto certifieras: Wink granskar varje byrås registrering innan den kan boka. Byråer som vill ta betalt direkt från sina kunder, som merchant of record, måste boka via Partner API och få Winks skriftliga godkännande. Se Kom igång som resebyrå och Partner API-referensen.