Skip to content

Greitas pradėjimas

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

  • tiesiogines viešbučių kainas mieste, gautas per Partnerių API,
  • užsakymo nuorodą, kuria siunčiami užsakymai bus priskiriami jūsų paskyrai,
  • testinį užsakymą ir webhook pranešimą apie jo įvykdymą.

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

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ą

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

Jums reikės:

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

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

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. Pasirinkite sritis (scopes) – Inventory & rates (skaitymas). Partnerių 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. Programos kitus kliento tipus ir sritis.

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.

Jei žetono užklausa atmesta, atsakymas yra JSON su error kodu:

errorHTTP statusasDažniausia priežastis
invalid_client401Neteisingas kliento ID arba slaptažodis, arba gamybos prisijungimai naudoti staging-iam
invalid_scope400Užklausa prašo srities, kurios programa neturi
unauthorized_client400Programa neturi teisės naudoti client_credentials grant’o
invalid_request400Trūksta privalomo parametro, pvz., kūnas yra JSON, o ne forma

Kiekviename Partnerių API kvietime nurodoma paskyra, už kurią veikiate, per managing-entity-id antraštę. Išvardinkite paskyras, kurioms jūsų žetonas turi teisę 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”

Testavimo aplinkoje yra testiniai viešbučiai su laisvomis vietomis Bankoke, todėl ši paieška naudoja jo slapyvardį 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

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, slapyvardį, kurio reikia užsakymo nuorodai.

Kainos yra sveikieji skaičiai mažesnėmis valiutos vienetų dalimis: padalinkite iš 10 laipsniu currencyExponent iš atsakymo (2 USD atveju, tad 12500 yra $125.00).

Nežinote miesto slapyvardžio? Išsiaiškinkite jį su wink.partner.v1.Lookup/Search. Pilną objekto turinį gaukite per Content servisą. Partnerių API dokumentacija aprašo kiekvieną kvietimą.

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 Kliento ID iš 2 žingsnio.
  • configuration-id yra jūsų pritaikymo ID: Manage account > Customizations. Pritaikymas nustato jūsų prekės ženklą, numatytą kalbą ir valiutą užsakymo puslapyje.

Pridėkite keliautojo datas, svečius, kalbą ir valiutą prie tos pačios nuorodos, kad viešbučio puslapis atsidarytų su užpildytais laukais:

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
ParametrasReikšmėPavyzdys
sdAtvykimo datasd=2027-03-14
n arba edNakvynių skaičius arba išvykimo datan=2 arba ed=2027-03-16
rcSvečių skaičius kambaryjerc=a2 (2 suaugusieji)
lRodoma kalbal=en
cRodoma valiutac=USD
pAkcijos kodasp=ABC123

Šie parametrai pakeičia numatytuosius, nustatytus jūsų pritaikyme. Mygtuko Užsakyti dabar vadovas aprašo pilną rc formatą, įskaitant vaikus ir kelis kambarius.

Nuoroda atidaro viešbučio puslapį; ji negali iš anksto pasirinkti kambario ar kainos. Keliautojas pasirenka kambarį viešbučio puslapyje už tiesioginę kainą.

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

Atidarykite savo nuorodą, pasirinkite datas ir kambarį, ir atsiskaitykite su Stripe testine kortele, pvz., 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 testinį įvykį, tada atlikite dar vieną testinį užsakymą ir stebėkite, kaip jis atkeliauja.

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

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

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

  2. Pašalinkite staging- iš kiekvieno host’o:

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

Partnerių API naudojimas matuojamas viešbučio-nakvynių vienetais, su nemokamu mėnesiniu limitu. Žr. Partnerių API kainodarą ir ribas.

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, turi užsakyti per Partnerių API ir gauti Wink raštišką patvirtinimą. Žr. Pradžia kaip kelionių agentūra ir Partnerių API dokumentaciją.