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.
Är det här rätt guide för dig?
Section titled “Är det här rätt guide för dig?”| 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 provision | Den 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 integration | Web Components |
| Låta en AI-agent söka och boka | MCP Servers och Agentic Payments |
| Koppla en channel manager eller PMS | Lägg till din channel manager |
Hur det fungerar
Section titled “Hur det fungerar”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.
Innan du börjar
Section titled “Innan du börjar”Du behöver:
grpcurl, eller Postman eller Insomnia. Partner API är gRPC, inte REST.curl.
Steg 1: Skapa ett stagingkonto
Section titled “Steg 1: Skapa ett stagingkonto”Staging är helt separat från produktion, med egna inloggningar och konton.
-
Gå till staging-app.wink.travel, klicka på
Sign-In / Registeroch registrera dig. -
Klicka på
Accountsi vänstra sidomenyn, sedanCreate, och välj I am an Affiliate. Bokningar du skickar krediteras detta konto. Se Skapa konto.
Steg 2: Skapa en applikation
Section titled “Steg 2: Skapa en applikation”Applikationen ger din kod dess behörigheter.
-
På ditt kontokort, klicka
Actions>Manage account, sedan flikenApplications. -
Klicka
Create new application, ge den ett namn och välj Machine-to-machine som klienttyp. -
Under scopes, välj Inventory & rates (read). Partner API kontrollerar för
inventory.read. -
Klicka
Create applicationoch 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.
Steg 3: Skaffa en access-token
Section titled “Steg 3: Skaffa en access-token”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:
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:
error | HTTP-status | Vanlig orsak |
|---|---|---|
invalid_client | 401 | Fel client ID eller secret, eller produktionsbehörigheter använda på staging-iam |
invalid_scope | 400 | Förfrågan ber om ett scope som applikationen inte är registrerad för |
unauthorized_client | 400 | Applikationen har inte tillåtelse att använda client_credentials-grant |
invalid_request | 400 | En obligatorisk parameter saknas, till exempel när kroppen är JSON istället för ett formulär |
Steg 4: Hitta ditt konto-ID
Section titled “Steg 4: Hitta ditt konto-ID”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:
grpcurl -H "authorization: Bearer $WINK_TOKEN" \ -d '{}' \ staging-partner.wink.travel:443 wink.partner.v1.Accounts/ListAccountsKopiera accountId för affiliate-kontot från Steg 1:
export WINK_ACCOUNT_ID=<accountId>Steg 5: Sök hotell i en stad
Section titled “Steg 5: Sök hotell i en stad”Staging har testhotell med tillgänglighet i Bangkok, så denna sökning använder dess slug, bangkok-thailand:
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/SearchByCityAnvänd ett incheckningsdatum i framtiden; ett tidigare datum avvisas. Varje resultat innehåller:
name,starRatingochheroImageUrl, 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.
Steg 6: Bygg bokningslänken
Section titled “Steg 6: Bygg bokningslänken”https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID><urlName>är hotelletsurlNamefrå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.
Skicka med resenärens sökdata
Section titled “Skicka med resenärens sökdata”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| Parameter | Betydelse | Exempel |
|---|---|---|
sd | Incheckningsdatum | sd=2027-03-14 |
n eller ed | Antal nätter, eller utcheckningsdatum | n=2 eller ed=2027-03-16 |
rc | Gäster per rum | rc=a2 (2 vuxna) |
l | Visningsspråk | l=en |
c | Visningsvaluta | c=USD |
p | Kampanjkod | p=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.
Steg 7: Gör en testbokning
Section titled “Steg 7: Gör en testbokning”Ö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.
Steg 8: Få notiser om bokningar
Section titled “Steg 8: Få notiser om bokningar”-
I Portal, gå till
Applications > Webhooksoch lägg till en endpoint som accepterarPOST-förfrågningar. -
Prenumerera på
booking.create, eller lämna händelselistan tom för att ta emot allt medan du utvecklar. -
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.
Steg 9: Gå till produktion
Section titled “Steg 9: Gå till produktion”Det finns inget godkännandesteg för utvecklare. (Resebyråkonto certifieras först; se nedan.) När din integration fungerar i staging:
-
Skapa ett konto och en applikation på app.wink.travel, som i Steg 1 och 2. Behörigheter överförs inte mellan miljöer.
-
Ta bort
staging-från varje host:Staging Produktion https://staging-iam.wink.travelhttps://iam.wink.travelstaging-partner.wink.travel:443partner.wink.travel:443https://staging-book.wink.travelhttps://book.wink.travel -
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.
Boka som resebyrå
Section titled “Boka som resebyrå”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.
Nästa steg
Section titled “Nästa steg”- Generera en typad klient från
.proto-schemat istället för att anropagrpcurlmanuellt. - Koppla MCP-servern och använd AI Skills för att låta din kodassistent skriva integrationen mot live-API:et.
- Läs hela listan över miljöer och hosts.
