Skip to content

Brzi početak

Ovaj vodič vodi vas od početka do funkcionalne integracije za otprilike 30 minuta. Na kraju ćete imati:

  • cijene hotela uživo u nekom gradu, iz Partner API-ja,
  • poveznicu za rezervaciju koja pripisuje rezervacije na vaš račun,
  • testnu rezervaciju i webhook koji vas obavještava da se dogodila.

Sve se odvija u staging okruženju, našem testnom okruženju. Ne trebate tražiti pristup od nas, a prelazak u produkciju kasnije također ne zahtijeva odobrenje.

Želite…Počnite ovdje
Prikazivati hotele u svojoj aplikaciji, web stranici ili AI proizvodu i slati putnike na rezervaciju, zarađujući provizijuOvaj vodič
Rezervirati u ime svojih klijenata kao licencirana putnička agencijaOvaj vodič do Koraka 5, zatim Rezervacija kao putnička agencija
Ugraditi rezervabilne hotele bez pisanja integracijeWeb Components
Dopustiti AI agentu da pretražuje i rezerviraMCP Servers i Agentic Payments
Povezati channel manager ili PMSDodajte svoj Channel Manager

Koristite Partner API za pronalazak hotela i njihovih cijena uživo. Svaki hotel ima stabilan urlName. Pretvarate ga u poveznicu na Wink Booking Engine, book.wink.travel, koja nosi vaše ID-jeve. Putnik rezervira i plaća tamo, a rezervacija se pripisuje vašem računu.

Trebat će vam:

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

Staging je potpuno odvojen od produkcije, s vlastitim prijavama i računima.

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

  2. Kliknite Accounts u lijevom izborniku, zatim Create i odaberite I am an Affiliate. Rezervacije koje šaljete pripisuju se ovom računu. Pogledajte Create Account.

Aplikacija daje vašem kodu vjerodajnice.

  1. Na kartici svog računa kliknite Actions > Manage account, zatim karticu Applications.

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

  3. Pod scopes odaberite Inventory & rates (read). Partner API provjerava 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 scopeove.

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"

Spremite access_token iz odgovora:

Terminal window
export WINK_TOKEN=<access_token>

Tokeni istječu. U vlastitom kodu koristite OAuth2 biblioteku za dohvat i osvježavanje tokena. Pogledajte Authentication.

Ako je zahtjev za token odbijen, odgovor je JSON tijelo s error kodom:

errorHTTP statusUobičajeni razlog
invalid_client401Pogrešan client ID ili secret, ili su korištene produkcijske vjerodajnice na staging-iam
invalid_scope400Zahtjev traži scope za koji aplikacija nije registrirana
unauthorized_client400Aplikacija nema dopuštenje za korištenje client_credentials grant tipa
invalid_request400Nedostaje obavezni parametar, npr. tijelo je JSON umjesto forme

Svaki Partner API poziv navodi račun za koji djelujete u zaglavlju managing-entity-id. Nabrojite račune za koje vaš token može djelovati:

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

Kopirajte accountId affiliate računa iz Koraka 1:

Terminal window
export WINK_ACCOUNT_ID=<accountId>

Staging ima testne hotele s 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 retka rezultata,
  • roomTypes, ponude uživo, najjeftinija soba prva,
  • urlName, slug koji vam treba za poveznicu za rezervaciju.

Cijene su cijeli brojevi u manjim jedinicama: podijelite s 10 na potenciju currencyExponent iz odgovora (2 za USD, pa je 12500 $125.00).

Ne znate slug grada? Riješite ga s wink.partner.v1.Lookup/Search. Za puni sadržaj objekta koristite servis Content. Partner API referenca dokumentira svaki poziv.

Korak 6: Izradite poveznicu za rezervaciju

Section titled “Korak 6: Izradite poveznicu za rezervaciju”
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 prilagodbe: Manage account > Customizations. Prilagodba također postavlja vaš branding, zadani jezik i valutu na stranici za rezervaciju.

Dodajte datume, goste, jezik i valutu putnika u istu poveznicu da se stranica hotela otvori s tim podacima ispunjenim:

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čenjePrimjer
sdDatum prijavesd=2027-03-14
n ili edBroj noćenja ili datum odjaven=2 ili ed=2027-03-16
rcGosti po sobirc=a2 (2 odrasle osobe)
lJezik prikazal=en
cValuta prikazac=USD
pPromotivni kodp=ABC123

Ovi parametri nadjačavaju zadane postavke iz vaše prilagodbe. Vodič za Book Now button objašnjava puni format rc, uključujući djecu i više soba.

Poveznica otvara stranicu hotela; ne može unaprijed odabrati sobu ili cijenu. Putnik bira sobu na stranici hotela, po cijeni uživo.

Pogledajte Linking directly za povezivanje na početnu stranicu booking enginea umjesto na pojedinačni hotel.

Otvorite svoju poveznicu, odaberite datume i sobu, te platite s Stripe test karticom, na primjer 4242 4242 4242 4242 s bilo kojim budućim datumom isteka i bilo kojim CVC-om. U stagingu se ne naplaćuje stvarna kartica. Zabilježite kod rezervacije na stranici potvrde; počinje s WNK.

Korak 8: Primajte obavijesti o rezervacijama

Section titled “Korak 8: Primajte obavijesti o rezervacijama”
  1. U Portalu idite na Applications > Webhooks i dodajte endpoint koji prihvaća POST zahtjeve.

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

  3. Pošaljite sebi testni događaj, zatim napravite još jednu testnu rezervaciju i pratite dolazak obavijesti.

Provjerite potpis svake isporuke prije nego joj vjerujete. Pogledajte Webhook Integration i Webhook Events Catalog.

Ne postoji korak odobrenja za developere. (Računi putničkih agencija se prvo certificiraju; pogledajte dolje.) Kad vaša integracija radi u stagingu:

  1. Kreirajte račun i aplikaciju na app.wink.travel, kao u Koracima 1 i 2. Vjerodajnice se ne prenose 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. Ponovno pronađite svoj produkcijski account ID (Korak 4) i customization ID (Korak 6). Oni se razlikuju od staginga.

Korištenje Partner API-ja mjeri se u noćenjima u hotelu, s mjesečnim besplatnim limitom. Pogledajte Partner API za cijene i ograničenja.

Ako je vaš račun licencirana putnička agencija, ne morate slati putnike na book.wink.travel: možete kreirati rezervacije direktno s wink.partner.v1.Booking/CreateBooking i upravljati njima s ostalim Booking pozivima. Ostali računi šalju putnike na poveznicu za rezervaciju.

Računi putničkih agencija se certificiraju: Wink pregledava registraciju svake agencije prije nego što može rezervirati. Agencije koje žele same naplaćivati svoje klijente, kao trgovci, moraju rezervirati preko Partner API-ja i dobiti pismeno odobrenje Wink-a. Pogledajte Getting Started as a Travel Agency i Partner API referencu.