Skip to content

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.

Želite da…Počnite ovde
Prikažete hotele u svojoj aplikaciji, sajtu ili AI proizvodu i šaljete putnike da rezervišu, zarađujući provizijuOvaj vodič
Rezervišete u ime svojih klijenata kao licencirana turistička agencijaOvaj vodič do Koraka 5, zatim Rezervacija kao turistička agencija
Ugradite hotele za rezervaciju bez pisanja integracijeWeb komponente
Dozvolite AI agentu da pretražuje i rezervišeMCP serveri i Agentic Payments
Povežete channel manager ili PMSDodajte svoj channel manager

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.

Trebaće vam:

  • grpcurl, ili Postman ili Insomnia. Partner API je gRPC, ne REST.
  • curl.

Staging je potpuno odvojen od produkcije, sa sopstvenim prijavama i nalozima.

  1. Idite na staging-app.wink.travel, kliknite na Sign-In / Register i registrujte se.

  2. Kliknite na Accounts u levom meniju, zatim Create, i izaberite I am an Affiliate. Rezervacije koje šaljete pripisuju se ovom nalogu. Pogledajte Kreiranje naloga.

Aplikacija daje vašem kodu njegove akreditive.

  1. Na kartici vašeg naloga kliknite Actions > Manage account, zatim karticu Applications.

  2. Kliknite Create new application, dajte joj ime i izaberite Machine-to-machine kao tip klijenta.

  3. Pod scopes izaberite Inventory & rates (read). Partner API proverava inventory.read.

  4. Kliknite Create application i 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.

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"

Sačuvajte access_token iz odgovora:

Terminal window
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:

errorHTTP statusUobičajeni razlog
invalid_client401Pogrešan client ID ili secret, ili su korišćeni produkcijski akreditive na staging-iam
invalid_scope400Zahtev traži scope za koji aplikacija nije registrovana
unauthorized_client400Aplikacija nema dozvolu za client_credentials grant
invalid_request400Nedostaje obavezni parametar, na primer kada je telo JSON umesto forme

Svaki Partner API poziv navodi nalog za koji delujete u managing-entity-id zaglavlju. Nabrojte naloge za koje vaš token može delovati:

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

Kopirajte accountId affiliate naloga iz Koraka 1:

Terminal window
export WINK_ACCOUNT_ID=<accountId>

Staging ima test hotele sa dostupnošću u Bangkoku, pa ova pretraga koristi njegov slug, 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

Koristite datum prijave u budućnosti; prošli datum se odbija. Svaki rezultat sadrži:

  • name, starRating i heroImageUrl, 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.

https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID>
  • <urlName> je urlName hotela iz Koraka 5.
  • client-id je Client ID vaše aplikacije iz Koraka 2.
  • configuration-id je vaš ID prilagođavanja: Manage account > Customizations. Prilagođavanje takođe postavlja vaš brending, podrazumevani jezik i valutu na stranici za rezervaciju.

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
ParametarZnačenjePrimer
sdDatum prijavesd=2027-03-14
n ili edBroj noći ili datum odjaven=2 ili ed=2027-03-16
rcGosti po sobirc=a2 (2 odrasla)
lJezik prikazal=en
cValuta prikazac=USD
pPromo kodp=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.

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”
  1. U Portalu idite na Applications > Webhooks i dodajte endpoint koji prihvata POST zahteve.

  2. Pretplatite se na booking.create, ili ostavite listu događaja praznom da primate sve dok razvijate.

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

Ne postoji korak odobrenja za developere. (Nalozi turističkih agencija se prvo sertifikuju; pogledajte ispod.) Kada vaša integracija radi u stagingu:

  1. Kreirajte nalog i aplikaciju na app.wink.travel, kao u Koracima 1 i 2. Akreditive ne možete preneti između okruženja.

  2. Uklonite staging- iz svakog hosta:

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

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.