Skip to content
Wink

Greitas pradėjimas

Šis vadovas padės jums per maždaug 30 minučių sukurti veikiančią integraciją. Pabaigoje turėsite:

  • tiesiogines viešbučių kainas mieste, gautas per Partner API,
  • užsakymo nuorodą, kuri priskiria užsakymus jūsų paskyrai,
  • bandomąjį užsakymą ir webhook pranešimą apie jo įvykdymą.

Visa tai vyksta testavimo aplinkoje (staging), mūsų testavimo aplinkoje. Jums nereikia prašyti prieigos, o perėjimas į gamybą vėliau taip pat nereikalauja patvirtinimo.

Ar šis vadovas jums tinkamas?

Section titled “Ar šis vadovas jums tinkamas?”
Jūs norite…Pradėkite čia
Rodyti viešbučius savo programoje, svetainėje ar AI produkte ir siųsti keliautojus užsakyti, uždirbant komisiniusŠis vadovas
Užsakyti klientų vardu kaip licencijuota kelionių agentūraŠis vadovas iki 5 žingsnio, tada Užsakymas kaip kelionių agentūra
Įterpti užsakomuosius viešbučius be integracijos rašymoWeb Components
Leisti AI agentui ieškoti ir užsakytiMCP Servers ir Agentic Payments
Prijungti kanalų valdymo sistemą arba PMSPridėti savo kanalų valdymo sistemą

Kaip tai veikia

Section titled “Kaip tai veikia”

Naudojate Partner API, kad rastumėte viešbučius ir jų tiesiogines kainas. Kiekvienas viešbutis turi stabilų urlName. Jūs jį paverčiate nuoroda į Wink Booking Engine, book.wink.travel, perduodant savo ID. Keliautojas užsako ir apmoka ten, o užsakymas priskiriamas jūsų paskyrai.

Prieš pradėdami

Section titled “Prieš pradėdami”

Jums reikės:

  • grpcurl, arba Postman ar Insomnia. Partner API yra gRPC, ne REST.
  • curl.

1 žingsnis: Sukurkite testavimo paskyrą

Section titled “1 žingsnis: Sukurkite testavimo paskyrą”

Testavimo aplinka yra visiškai atskirta nuo gamybos, su savo prisijungimais ir paskyromis.

  1. Eikite į staging-app.wink.travel, spustelėkite Sign-In / Register ir užsiregistruokite.

  2. Kairėje šoninėje juostoje spustelėkite Accounts, tada Create ir pasirinkite I am an Affiliate. Užsakymai, kuriuos siunčiate, bus priskiriami šiai paskyrai. Žr. Sukurti paskyrą.

2 žingsnis: Sukurkite programą

Section titled “2 žingsnis: Sukurkite programą”

Programa suteikia jūsų kodui prisijungimo duomenis.

  1. Ant savo paskyros kortelės spustelėkite Actions > Manage account, tada skirtuką Applications.

  2. Spustelėkite Create new application, pavadinkite ją ir pasirinkite Machine-to-machine kaip kliento tipą.

  3. Skiltyje scopes pasirinkite Inventory & rates (skaitymas). Partner API tikrina inventory.read.

  4. Spustelėkite Create application ir nukopijuokite Client ID ir Client secret. Slaptažodis rodomas tik vieną kartą ir vėliau jo negalima atgauti.

Žr. Applications dėl kitų kliento tipų ir scopes.

3 žingsnis: Gaukite prieigos žetoną

Section titled “3 žingsnis: Gaukite prieigos žetoną”
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"

Iš atsakymo išsaugokite access_token:

Terminal window
export WINK_TOKEN=<access_token>

Žetonai baigiasi. Savo kode leiskite OAuth2 bibliotekai juos gauti ir atnaujinti. Žr. Autentifikacija.

4 žingsnis: Suraskite savo paskyros ID

Section titled “4 žingsnis: Suraskite savo paskyros ID”

Kiekviename Partner API kvietime nurodoma paskyra, už kurią veikiate, managing-entity-id antraštėje. Išvardinkite paskyras, už kurias jūsų žetonas gali veikti:

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

Nukopijuokite 1 žingsnyje sukurtos filialo paskyros accountId:

Terminal window
export WINK_ACCOUNT_ID=<accountId>

5 žingsnis: Ieškokite viešbučių mieste

Section titled “5 žingsnis: Ieškokite viešbučių mieste”
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

Naudokite ateities datą; praeities data bus atmesta. Kiekvienas rezultatas turi:

  • name, starRating ir heroImageUrl, pakankamai rezultatų eilutei parodyti,
  • roomTypes, tiesioginius pasiūlymus, nuo pigiausio kambario,
  • urlName, reikalingą užsakymo nuorodai.

Kainos yra sveikieji skaičiai smulkiausiomis valiutos vienetų dalimis: padalinkite iš 10 laipsniu currencyExponent iš atsakymo (2 USD atveju, taigi 12500 yra 125,00 $).

Nežinote miesto slugo? Išsiaiškinkite jį su wink.partner.v1.Lookup/Search. Pilnam objekto turiniui naudokite Content servisą. Partner API dokumentacija aprašo kiekvieną kvietimą.

6 žingsnis: Sukurkite užsakymo nuorodą

Section titled “6 žingsnis: Sukurkite užsakymo nuorodą”
https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID>
  • <urlName> yra viešbučio urlName iš 5 žingsnio.
  • client-id yra jūsų programos Client ID iš 2 žingsnio.
  • configuration-id yra jūsų pritaikymo ID: Manage account > Customizations. Pritaikymas taip pat nustato jūsų prekės ženklą, numatytą kalbą ir valiutą užsakymo puslapyje.

Žr. Tiesioginis susiejimas, jei norite susieti su užsakymo variklio pagrindiniu puslapiu, o ne su vienu viešbučiu.

7 žingsnis: Atlikite bandomąjį užsakymą

Section titled “7 žingsnis: Atlikite bandomąjį užsakymą”

Atidarykite savo nuorodą, pasirinkite datas ir kambarį, ir atsiskaitykite su Stripe bandomąja kortele, pavyzdžiui 4242 4242 4242 4242 su bet kokia ateities galiojimo data ir bet kokiu CVC. Testavimo aplinkoje tikra kortelė nebus nuskaičiuota. Užsakymo patvirtinimo puslapyje užsirašykite užsakymo kodą; jis prasideda WNK.

8 žingsnis: Gaukite pranešimus apie užsakymus

Section titled “8 žingsnis: Gaukite pranešimus apie užsakymus”

  1. Portale eikite į Applications > Webhooks ir pridėkite galinį tašką, kuris priima POST užklausas.

  2. Užsiprenumeruokite booking.create arba palikite įvykių sąrašą tuščią, kad gautumėte viską kūrimo metu.

  3. Išsiųskite sau bandomąjį įvykį, tada atlikite dar vieną bandomąjį užsakymą ir stebėkite, kaip jis atkeliauja.

Prieš pasitikėdami, patikrinkite kiekvieno pranešimo parašą. Žr. Webhook integracija ir Webhook įvykių katalogą.

9 žingsnis: Pereikite į gamybą

Section titled “9 žingsnis: Pereikite į gamybą”

Kūrėjams nereikia patvirtinimo žingsnio. (Kelionių agentūrų paskyros pirmiausia yra sertifikuojamos; žr. žemiau.) Kai jūsų integracija veikia testavimo aplinkoje:

  1. Sukurkite paskyrą ir programą app.wink.travel, kaip 1 ir 2 žingsniuose. Prisijungimo duomenys nėra perkelti tarp aplinkų.

  2. Pašalinkite staging- iš kiekvieno hosto:

    Testavimo aplinkaGamyba
    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. Dar kartą suraskite savo gamybos paskyros ID (4 žingsnis) ir pritaikymo ID (6 žingsnis). Jie skiriasi nuo testavimo aplinkos.

Partner API naudojimas matuojamas viešbučio nakvynėmis, su nemokamu mėnesiniu limitu. Žr. Partner API dėl kainodaros ir apribojimų.

Užsakymas kaip kelionių agentūra

Section titled “Užsakymas kaip kelionių agentūra”

Jei jūsų paskyra yra licencijuota kelionių agentūra, jums nereikia siųsti keliautojų į book.wink.travel: galite kurti užsakymus tiesiogiai su wink.partner.v1.Booking/CreateBooking ir valdyti juos kitais Booking kvietimais. Kitos paskyros siunčia keliautojus į užsakymo nuorodą.

Kelionių agentūrų paskyros yra sertifikuojamos: Wink peržiūri kiekvienos agentūros registraciją prieš leidžiant užsakyti. Agentūros, norinčios pačios rinkti mokėjimus iš klientų kaip oficialūs pardavėjai, privalo užsakyti per Partner API ir gauti Wink raštišką patvirtinimą. Žr. Pradžia kelionių agentūroms ir Partner API dokumentaciją.

Tolimesni žingsniai

Section titled “Tolimesni žingsniai”