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.
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šymo | Web Components |
| Leisti AI agentui ieškoti ir užsakyti | MCP Servers ir Agentic Payments |
| Prijungti kanalų valdymo sistemą arba PMS | Pridėti savo kanalų valdymo sistemą |
Kaip tai veikia
Section titled “Kaip tai veikia”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.
Prieš pradėdami
Section titled “Prieš pradėdami”Jums reikės:
grpcurl, arba Postman ar Insomnia. Partnerių 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.
-
Eikite į staging-app.wink.travel, spustelėkite
Sign-In / Registerir užsiregistruokite. -
Kairėje šoninėje juostoje spustelėkite
Accounts, tadaCreateir 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.
-
Ant savo paskyros kortelės spustelėkite
Actions>Manage account, tada skirtukąApplications. -
Spustelėkite
Create new application, pavadinkite ją ir pasirinkite Machine-to-machine kaip kliento tipą. -
Pasirinkite sritis (scopes) – Inventory & rates (skaitymas). Partnerių API tikrina
inventory.read. -
Spustelėkite
Create applicationir 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.
3 žingsnis: Gaukite prieigos žetoną
Section titled “3 žingsnis: Gaukite prieigos žetoną”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:
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:
error | HTTP statusas | Dažniausia priežastis |
|---|---|---|
invalid_client | 401 | Neteisingas kliento ID arba slaptažodis, arba gamybos prisijungimai naudoti staging-iam |
invalid_scope | 400 | Užklausa prašo srities, kurios programa neturi |
unauthorized_client | 400 | Programa neturi teisės naudoti client_credentials grant’o |
invalid_request | 400 | Trūksta privalomo parametro, pvz., kūnas yra JSON, o ne forma |
4 žingsnis: Suraskite savo paskyros ID
Section titled “4 žingsnis: Suraskite savo paskyros ID”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:
grpcurl -H "authorization: Bearer $WINK_TOKEN" \ -d '{}' \ staging-partner.wink.travel:443 wink.partner.v1.Accounts/ListAccountsNukopijuokite 1 žingsnyje sukurtos filialo paskyros accountId:
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:
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/SearchByCityNaudokite ateities datą; praeities data bus atmesta. Kiekvienas rezultatas turi:
name,starRatingirheroImageUrl, 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ą.
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čiourlNameiš 5 žingsnio.client-idyra jūsų programos Kliento ID iš 2 žingsnio.configuration-idyra jūsų pritaikymo ID:Manage account>Customizations. Pritaikymas nustato jūsų prekės ženklą, numatytą kalbą ir valiutą užsakymo puslapyje.
Perduokite keliautojo paieškos duomenis
Section titled “Perduokite keliautojo paieškos duomenis”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| Parametras | Reikšmė | Pavyzdys |
|---|---|---|
sd | Atvykimo data | sd=2027-03-14 |
n arba ed | Nakvynių skaičius arba išvykimo data | n=2 arba ed=2027-03-16 |
rc | Svečių skaičius kambaryje | rc=a2 (2 suaugusieji) |
l | Rodoma kalba | l=en |
c | Rodoma valiuta | c=USD |
p | Akcijos kodas | p=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.
7 žingsnis: Atlikite testinį užsakymą
Section titled “7 žingsnis: Atlikite testinį užsakymą”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”-
Portale eikite į
Applications > Webhooksir pridėkite galinį tašką, kuris priimaPOSTužklausas. -
Užsiprenumeruokite
booking.createarba palikite įvykių sąrašą tuščią, kad gautumėte viską kūrimo metu. -
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ą.
9 žingsnis: Pereikite į gamybą
Section titled “9 žingsnis: Pereikite į gamybą”Kūrėjams nereikia patvirtinimo žingsnio. (Kelionių agentūrų paskyros yra sertifikuojamos iš anksto; žr. žemiau.) Kai jūsų integracija veikia testavimo aplinkoje:
-
Sukurkite paskyrą ir programą app.wink.travel, kaip 1 ir 2 žingsniuose. Prisijungimai nėra perkelti tarp aplinkų.
-
Pašalinkite
staging-iš kiekvieno host’o:Testavimo aplinka Gamyba https://staging-iam.wink.travelhttps://iam.wink.travelstaging-partner.wink.travel:443partner.wink.travel:443https://staging-book.wink.travelhttps://book.wink.travel -
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.
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, turi užsakyti per Partnerių API ir gauti Wink raštišką patvirtinimą. Žr. Pradžia kaip kelionių agentūra ir Partnerių API dokumentaciją.
Tolimesni žingsniai
Section titled “Tolimesni žingsniai”- Sugeneruokite tipizuotą klientą iš
.protoschemos vietoje rankiniogrpcurlnaudojimo. - Prijunkite MCP serverį ir naudokite AI įgūdžius, kad jūsų programavimo asistentas parašytų integraciją tiesiogiai su gyvu API.
- Perskaitykite pilną aplinkų ir hostų sąrašą.
