Brzi početak
Ovaj vodič vas vodi od početka do funkcionalne integracije za oko 30 minuta. Na kraju ćete imati:
- aktuelne cene hotela u nekom gradu, iz Partner API-ja,
- link za rezervaciju koji pripisuje rezervacije na vaš nalog,
- test rezervaciju i webhook koji vas obaveštava da se desila.
Sve se dešava u staging okruženju, našem testnom okruženju. Ne morate tražiti pristup od nas, a prelazak u produkciju kasnije ne zahteva odobrenje.
Da li je ovaj vodič pravi za vas?
Section titled “Da li je ovaj vodič pravi za vas?”| Želite da… | Počnite ovde |
|---|---|
| Prikažete hotele u svojoj aplikaciji, sajtu ili AI proizvodu i šaljete putnike da rezervišu, zarađujući proviziju | Ovaj vodič |
| Rezervišete u ime svojih klijenata kao licencirana turistička agencija | Ovaj vodič do Koraka 5, zatim Rezervacija kao turistička agencija |
| Ugradite hotele za rezervaciju bez pisanja integracije | Web komponente |
| Dozvolite AI agentu da pretražuje i rezerviše | MCP serveri i Agentic Payments |
| Povežete channel manager ili PMS | Dodajte svoj channel manager |
Kako to funkcioniše
Section titled “Kako to funkcioniše”Koristite Partner API da pronađete hotele i njihove aktuelne cene. Svaki hotel ima stabilan urlName. Pretvarate ga u link ka Wink Booking Engine-u, book.wink.travel, koji nosi vaše ID-jeve. Putnik rezerviše i plaća tamo, a rezervacija se pripisuje vašem nalogu.
Pre nego što počnete
Section titled “Pre nego što počnete”Trebaće vam:
grpcurl, ili Postman ili Insomnia. Partner API je gRPC, ne REST.curl.
Korak 1: Kreirajte staging nalog
Section titled “Korak 1: Kreirajte staging nalog”Staging je potpuno odvojen od produkcije, sa sopstvenim prijavama i nalozima.
-
Idite na staging-app.wink.travel, kliknite na
Sign-In / Registeri registrujte se. -
Kliknite na
Accountsu levom meniju, zatimCreate, i izaberite I am an Affiliate. Rezervacije koje šaljete pripisuju se ovom nalogu. Pogledajte Kreiranje naloga.
Korak 2: Kreirajte aplikaciju
Section titled “Korak 2: Kreirajte aplikaciju”Aplikacija daje vašem kodu njegove akreditive.
-
Na kartici vašeg naloga kliknite
Actions>Manage account, zatim karticuApplications. -
Kliknite
Create new application, dajte joj ime i izaberite Machine-to-machine kao tip klijenta. -
Pod scopes izaberite Inventory & rates (read). Partner API proverava
inventory.read. -
Kliknite
Create applicationi kopirajte Client ID i Client secret. Tajni ključ se prikazuje samo jednom i kasnije se ne može dohvatiti.
Pogledajte Applications za ostale tipove klijenata i scope-ove.
Korak 3: Nabavite pristupni token
Section titled “Korak 3: Nabavite pristupni token”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"Sačuvajte access_token iz odgovora:
export WINK_TOKEN=<access_token>Tokeni ističu. U svom kodu koristite OAuth2 biblioteku za dohvatanje i osvežavanje tokena. Pogledajte Authentication.
Ako je zahtev za token odbijen, odgovor je JSON telo sa error kodom:
error | HTTP status | Uobičajeni razlog |
|---|---|---|
invalid_client | 401 | Pogrešan client ID ili secret, ili su korišćeni produkcijski akreditive na staging-iam |
invalid_scope | 400 | Zahtev traži scope za koji aplikacija nije registrovana |
unauthorized_client | 400 | Aplikacija nema dozvolu za client_credentials grant |
invalid_request | 400 | Nedostaje obavezni parametar, na primer kada je telo JSON umesto forme |
Korak 4: Pronađite ID svog naloga
Section titled “Korak 4: Pronađite ID svog naloga”Svaki Partner API poziv navodi nalog za koji delujete u managing-entity-id zaglavlju. Nabrojte naloge za koje vaš token može delovati:
grpcurl -H "authorization: Bearer $WINK_TOKEN" \ -d '{}' \ staging-partner.wink.travel:443 wink.partner.v1.Accounts/ListAccountsKopirajte accountId affiliate naloga iz Koraka 1:
export WINK_ACCOUNT_ID=<accountId>Korak 5: Pretražite hotele u gradu
Section titled “Korak 5: Pretražite hotele u gradu”Staging ima test hotele sa dostupnošću u Bangkoku, pa ova pretraga koristi njegov slug, 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/SearchByCityKoristite datum prijave u budućnosti; prošli datum se odbija. Svaki rezultat sadrži:
name,starRatingiheroImageUrl, dovoljno za prikaz reda rezultata,roomTypes, aktuelne ponude, najjeftinija soba prva,urlName, slug koji vam treba za link za rezervaciju.
Cene su celobrojne u manjim jedinicama: podelite sa 10 na stepen currencyExponent iz odgovora (2 za USD, pa je 12500 $125.00).
Ne znate slug grada? Rešite ga sa wink.partner.v1.Lookup/Search. Za kompletan sadržaj objekta koristite servis Content. Partner API referenca dokumentuje svaki poziv.
Korak 6: Napravite link za rezervaciju
Section titled “Korak 6: Napravite link za rezervaciju”https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID><urlName>jeurlNamehotela iz Koraka 5.client-idje Client ID vaše aplikacije iz Koraka 2.configuration-idje vaš ID prilagođavanja:Manage account>Customizations. Prilagođavanje takođe postavlja vaš brending, podrazumevani jezik i valutu na stranici za rezervaciju.
Prosledite pretragu putnika
Section titled “Prosledite pretragu putnika”Dodajte datume, goste, jezik i valutu putnika u isti link da se stranica hotela otvori sa tim podacima popunjenim:
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| Parametar | Značenje | Primer |
|---|---|---|
sd | Datum prijave | sd=2027-03-14 |
n ili ed | Broj noći ili datum odjave | n=2 ili ed=2027-03-16 |
rc | Gosti po sobi | rc=a2 (2 odrasla) |
l | Jezik prikaza | l=en |
c | Valuta prikaza | c=USD |
p | Promo kod | p=ABC123 |
Ovi parametri nadjačavaju podrazumevana podešavanja iz vašeg prilagođavanja. Vodič za Book Now dugme pokriva kompletan format rc, uključujući decu i više soba.
Link otvara stranicu hotela; ne može unapred izabrati sobu ili cenu. Putnik bira sobu na stranici hotela, po aktuelnoj ceni.
Pogledajte Direktno povezivanje za povezivanje na početnu stranicu booking engine-a umesto na pojedinačni hotel.
Korak 7: Napravite test rezervaciju
Section titled “Korak 7: Napravite test rezervaciju”Otvorite svoj link, izaberite datume i sobu, i platite sa Stripe test karticom, na primer 4242 4242 4242 4242 sa bilo kojim budućim datumom isteka i bilo kojim CVC. U stagingu se ne naplaćuje stvarna kartica. Zabeležite kod rezervacije na stranici potvrde; počinje sa WNK.
Korak 8: Dobijajte obaveštenja o rezervacijama
Section titled “Korak 8: Dobijajte obaveštenja o rezervacijama”-
U Portalu idite na
Applications > Webhooksi dodajte endpoint koji prihvataPOSTzahteve. -
Pretplatite se na
booking.create, ili ostavite listu događaja praznom da primate sve dok razvijate. -
Pošaljite sebi test događaj, zatim napravite još jednu test rezervaciju i pratite da li stiže.
Proverite potpis svakog isporučenog događaja pre nego što mu verujete. Pogledajte Webhook integraciju i Katalog webhook događaja.
Korak 9: Pređite u produkciju
Section titled “Korak 9: Pređite u produkciju”Ne postoji korak odobrenja za developere. (Nalozi turističkih agencija se prvo sertifikuju; pogledajte ispod.) Kada vaša integracija radi u stagingu:
-
Kreirajte nalog i aplikaciju na app.wink.travel, kao u Koracima 1 i 2. Akreditive ne možete preneti između okruženja.
-
Uklonite
staging-iz svakog hosta:Staging Produkcija https://staging-iam.wink.travelhttps://iam.wink.travelstaging-partner.wink.travel:443partner.wink.travel:443https://staging-book.wink.travelhttps://book.wink.travel -
Ponovo pronađite svoj produkcijski account ID (Korak 4) i customization ID (Korak 6). Oni se razlikuju od staginga.
Korišćenje Partner API-ja se meri u noćenjima u hotelu, sa mesečnim besplatnim limitom. Pogledajte Partner API za cene i limite.
Rezervacija kao turistička agencija
Section titled “Rezervacija kao turistička agencija”Ako je vaš nalog licencirana turistička agencija, ne morate slati putnike na book.wink.travel: možete praviti rezervacije direktno sa wink.partner.v1.Booking/CreateBooking i upravljati njima drugim Booking pozivima. Ostali nalozi šalju putnike na link za rezervaciju.
Nalozi turističkih agencija se sertifikuju: Wink proverava registraciju svake agencije pre nego što može da rezerviše. Agencije koje žele da same naplaćuju svoje klijente, kao trgovci, moraju rezervisati preko Partner API-ja i dobiti pismeno odobrenje od Wink-a. Pogledajte Početak rada kao turistička agencija i Partner API referencu.
Sledeći koraci
Section titled “Sledeći koraci”- Generišite tipizovanog klijenta iz
.protošeme umesto da ručno koristitegrpcurl. - Povežite MCP server i koristite AI Skills da vam pomoćnik za kodiranje napiše integraciju prema aktuelnom API-ju.
- Pročitajte kompletnu listu okruženja i hostova.
