Skip to content
Wink

Kom i gang raskt

Denne guiden tar deg fra ingenting til en fungerende integrasjon på omtrent 30 minutter. På slutten 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.

Er dette riktig guide for deg?

Section titled “Er dette riktig guide for deg?”
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

Slik fungerer det

Section titled “Slik fungerer det”

Du bruker Partner API for å finne hoteller og deres live priser. Hvert hotell har et stabilt urlName. Du gjør det 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.

Før du begynner

Section titled “Før du begynner”

Du trenger:

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

Steg 1: Opprett en staging-konto

Section titled “Steg 1: Opprett en staging-konto”

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.

Steg 2: Opprett en applikasjon

Section titled “Steg 2: Opprett en applikasjon”

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 (les). 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.

Steg 3: Få en tilgangstoken

Section titled “Steg 3: Få en tilgangstoken”
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>

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

Steg 4: Finn din konto-ID

Section titled “Steg 4: Finn din konto-ID”

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>

Steg 5: Søk etter hoteller i en by

Section titled “Steg 5: Søk etter hoteller i en by”
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 for 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.

Steg 6: Bygg bookingslenken

Section titled “Steg 6: Bygg bookingslenken”
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.

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

Steg 7: Gjør en testbooking

Section titled “Steg 7: Gjør en testbooking”

Å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.

Steg 8: Få varsler om bookinger

Section titled “Steg 8: Få varsler om bookinger”

  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 den komme inn.

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

Steg 9: Gå til produksjon

Section titled “Steg 9: Gå til produksjon”

Det kreves ingen godkjenningssteg for utviklere. (Reisebyråkontoer sertifiseres 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.

Booking som reisebyrå

Section titled “Booking som reisebyrå”

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 sertifiseres: 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å Winks skriftlige godkjenning. Se Kom i gang som reisebyrå og Partner API-referansen.

Neste steg

Section titled “Neste steg”