Skip to content

Kom i gang raskt

Denne guiden tar deg fra ingenting til en fungerende integrasjon på omtrent 30 minutter. Når du er ferdig vil du ha:

  • live priser for hoteller i en by, fra Partner API,
  • en bookingslenke som krediterer bookinger til din konto,
  • en testbooking, og en webhook som forteller deg at den skjedde.

Alt skjer i staging, vårt testmiljø. Du trenger ikke å be oss om tilgang, og det kreves heller ingen godkjenning for å gå til produksjon senere.

Du vil…Start her
Vise hoteller i appen, på nettstedet eller i AI-produktet ditt og sende reisende til booking, og tjene provisjonDenne guiden
Booke på vegne av dine kunder som et lisensiert reisebyråDenne guiden til og med Steg 5, deretter Booking som reisebyrå
Legge inn bookbare hoteller uten å skrive en integrasjonWeb Components
La en AI-agent søke og bookeMCP Servers og Agentic Payments
Koble til en channel manager eller PMSLegg til din channel manager

Du bruker Partner API for å finne hoteller og deres live priser. Hvert hotell har et stabilt urlName. Du gjør dette om til en lenke til Wink Booking Engine, book.wink.travel, som bærer dine ID-er. Den reisende booker og betaler der, og bookingen krediteres din konto.

Du trenger:

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

Staging er helt adskilt fra produksjon, med egne pålogginger og kontoer.

  1. Gå til staging-app.wink.travel, klikk Sign-In / Register og registrer deg.

  2. Klikk Accounts i venstre sidemeny, deretter Create, og velg I am an Affiliate. Bookinger du sender krediteres denne kontoen. Se Opprett konto.

Applikasjonen gir koden din legitimasjonen den trenger.

  1. På kontokortet ditt, klikk Actions > Manage account, deretter fanen Applications.

  2. Klikk Create new application, gi den et navn og velg Machine-to-machine som klienttype.

  3. Under scopes, velg Inventory & rates (read). Partner API sjekker for inventory.read.

  4. Klikk Create application og kopier Client ID og Client secret. Hemmeligheten vises én gang og kan ikke hentes senere.

Se Applications for de andre klienttypene 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"

Lagre access_token fra svaret:

Terminal window
export WINK_TOKEN=<access_token>

Tokens utløper. I din egen kode, la et OAuth2-bibliotek hente og fornye dem. Se Authentication.

Hvis token-forespørselen avvises, er svaret en JSON-kropp med en error-kode:

errorHTTP-statusVanlig årsak
invalid_client401Feil client ID eller secret, eller produksjonslegitimasjon brukt på staging-iam
invalid_scope400Forespørselen ber om et scope applikasjonen ikke er registrert for
unauthorized_client400Applikasjonen har ikke tillatelse til å bruke client_credentials grant
invalid_request400Et påkrevd parameter mangler, for eksempel når kroppen er JSON i stedet for et skjema

Hvert Partner API-kall navngir kontoen du handler for i en managing-entity-id header. List kontoene token ditt kan handle for:

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

Kopier accountId til affiliate-kontoen fra Steg 1:

Terminal window
export WINK_ACCOUNT_ID=<accountId>

Staging har testhoteller med tilgjengelighet i Bangkok, så dette søket bruker 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

Bruk en innsjekkingsdato i fremtiden; en dato i fortiden avvises. Hvert resultat inneholder:

  • name, starRating og heroImageUrl, nok til å vise en resultatlinje,
  • roomTypes, de live tilbudene, billigste rom først,
  • urlName, sluggen du trenger til bookingslenken.

Prisene er heltall i minste enhet: del på 10 opphøyd i currencyExponent fra svaret (2 for USD, så 12500 er $125,00).

Vet du ikke sluggen til en by? Finn den med wink.partner.v1.Lookup/Search. For fullstendig innhold om en eiendom, bruk Content-tjenesten. Partner API-referansen dokumenterer alle kall.

https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID>
  • <urlName> er hotellets urlName fra Steg 5.
  • client-id er Client ID-en til applikasjonen din fra Steg 2.
  • configuration-id er din tilpasnings-ID: Manage account > Customizations. En tilpasning setter også din merkevare, standardspråk og valuta på bookingsiden.

Legg til den reisendes datoer, gjester, språk og valuta i samme lenke slik at hotelsiden åpnes med disse utfylt:

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
sdInnsjekkingsdatosd=2027-03-14
n eller edAntall netter, eller utsjekkingsdaton=2 eller ed=2027-03-16
rcGjester per romrc=a2 (2 voksne)
lVisningsspråkl=en
cVisningsvalutac=USD
pKampanjekodep=ABC123

Disse parameterne overstyrer standardene satt i din tilpasning. Book Now button guide dekker hele rc-formatet, inkludert barn og flere rom.

Lenken åpner hotelsiden; den kan ikke forhåndsvelge rom eller pris. Den reisende velger rommet på hotelsiden, til live pris.

Se Lenke direkte for å lenke til bookingmotorens startside i stedet for et enkelt hotell.

Åpne lenken din, velg datoer og rom, og betal med et Stripe testkort, for eksempel 4242 4242 4242 4242 med en hvilken som helst fremtidig utløpsdato og hvilken som helst CVC. Ingen ekte kort belastes i staging. Merk deg bookingkoden på bekreftelsessiden; den starter med WNK.

  1. I Portal, gå til Applications > Webhooks og legg til et endepunkt som godtar POST-forespørsler.

  2. Abonner på booking.create, eller la hendelseslisten stå tom for å motta alt mens du utvikler.

  3. Send deg selv en testhendelse, lag deretter en ny testbooking og se at den kommer fram.

Verifiser signaturen på hver levering før du stoler på den. Se Webhook Integration og Webhook Events Catalog.

Det er ingen godkjenningsprosess for utviklere. (Reisebyråkontoer blir sertifisert først; se nedenfor.) Når integrasjonen din fungerer i staging:

  1. Opprett en konto og en applikasjon på app.wink.travel, som i Steg 1 og 2. Legitimasjon overføres ikke mellom miljøer.

  2. Fjern staging- fra alle hostnavn:

    StagingProduksjon
    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. Finn produksjonskonto-ID (Steg 4) og tilpasnings-ID (Steg 6) på nytt. De er forskjellige fra staging.

Partner API-bruk måles i hotellnetter, med en gratis månedlig kvote. Se Partner API for priser og begrensninger.

Hvis kontoen din er et lisensiert reisebyrå, trenger du ikke sende reisende til book.wink.travel: du kan opprette bookinger direkte med wink.partner.v1.Booking/CreateBooking, og administrere dem med de andre Booking-kallene. Andre kontoer sender reisende til bookingslenken i stedet.

Reisebyråkontoer blir sertifisert: Wink gjennomgår hver byråregistrering før det kan booke. Byråer som ønsker å innkreve betaling fra sine kunder selv, som merchant of record, må booke gjennom Partner API og få skriftlig godkjenning fra Wink. Se Kom i gang som reisebyrå og Partner API-referansen.