Aplikacije

Aplikacije vam kao programeru daju pristup svim funkcijama Wink-a. Možete pristupiti svim istim podacima i čak proširiti Wink-ove sopstvene funkcije. Možete izabrati da koristite Wink-ov OAuth2 server za autentifikaciju vašeg putničkog sajta na isti način kao što biste koristili Google ili Facebook. Na taj način možete proširiti Wink-ove funkcije na vaš sopstveni vebsajt ili aplikaciju.

Note

Vaša prva aplikacija je već kreirana kada napravite novi nalog. Koristimo tu aplikaciju za neke scenarije rezervacija.

Ne možete ponovo koristiti ovu aplikaciju. Molimo kreirajte nove aplikacije po potrebi.

Primer unosa aplikacije

Note

Aplikacija generisana na Wink-u može se koristiti za sve API krajnje tačke.

1. Izaberite nalog sa kojim želite da radite sa Nalozi.
2. Kliknite na Akcije na dnu kartice naloga i izaberite Upravljanje nalogom.
3. Kliknite na karticu Aplikacije na sledećoj stranici.
4. Ovaj odeljak će prikazati sve vaše aplikacije.
5. Rotirajte ili obrišite postojeću, ili kreirajte novu.

Kreirajte aplikaciju

Pošto ne možete pristupiti tajnom ključu aplikacije koju smo kreirali za vas, moraćete da napravite sopstvenu. Možete kreirati aplikaciju ovde bez prethodnog podešavanja nekretnine ili kompanije — nije vezana za nijedan specifičan nalog.

Tipovi klijenata

Prilikom kreiranja aplikacije, birate tip klijenta koji određuje kako se aplikacija autentifikuje. Ovo se kasnije ne može menjati — ako vam treba drugačiji tip, kreirajte novu aplikaciju.

• Veb aplikacija — Aplikacija renderovana na serveru koja može bezbedno da čuva klijentski tajni ključ (authorization code flow).
• Single-page app (SPA) — Aplikacija u pregledaču bez backend-a; koristi PKCE, bez klijentskog tajnog ključa.
• Mobilna aplikacija — Nativna iOS/Android aplikacija; koristi PKCE sa rotirajućim refresh tokenima.
• Machine-to-machine — Backend servis koji deluje kao samostalni klijent (client credentials); bez prijave korisnika.

Evo koraka za kreiranje aplikacije:

1. Na stranici aplikacija kliknite na dugme Kreiraj novu aplikaciju.
2. Ime Dajte svojoj aplikaciji ime. npr. Cool App
3. Tip klijenta Izaberite tip koji odgovara načinu na koji se vaša aplikacija autentifikuje — pogledajte Tipove klijenata iznad.
4. Redirect URI-jevi Potreban je bar jedan redirect URI. Koristi se za validaciju domena preusmeravanja nakon uspešne autentifikacije. Ne koristi se za Machine-to-machine aplikacije. npr. https://www.cool-site.com
5. Post-logout redirect URI-jevi (Opcionalno) URL-ovi na koje korisnici mogu biti preusmereni nakon odjave. Ostavite prazno da biste ponovo koristili redirect URI-jeve iznad.
6. Scope-ovi Izaberite na šta ova aplikacija može da pristupi u vaše ime — pogledajte Izbor scope-ova ispod.
7. Kliknite na dugme Kreiraj aplikaciju da nastavite.

Bićete preusmereni nazad na listu vaših aplikacija, a jednom dijalog prikazuje novi Client ID i Client secret. Kopirajte tajni ključ sada i sačuvajte ga na sigurnom mestu — nikada se više ne prikazuje i ne postoji način da ga kasnije povratite (možete samo rotirati za novi).

Izbor scope-ova

Svaka aplikacija uvek nosi Sign-in (OpenID Connect) scope-ove (openid, profile, email, offline_access) — oni potvrđuju identitet korisnika i održavaju ga prijavljenim, pa su označeni i zaključani; nisu opcija za izbor.

Sve ostalo je opcionalno. Preostali scope-ovi su grupisani u iste funkcionalne sekcije opisane u Scope-ovima — Nalog, Inventar i cene, Rezervacije, Marketing i promocije, Sadržaj nekretnine, Analitika i izveštaji, Integracije sa Channel manager-ima, Plaćanja i Knjigovodstvo i evidencija — svaki sa opisom na običnom jeziku šta otključava. Koristite linkove Sve / Ništa iznad liste da izaberete ili poništite sve opcione scope-ove odjednom.

Note

Plaćanja i Knjigovodstvo i evidencija su označeni kao Osetljivi jer štite tok novca — dodeljujte ih samo aplikacijama kojima je zaista potrebno da pristupaju plaćanjima ili evidenciji.

Dve grupe scope-ova namerno nisu ponuđene u ovom obrascu:

• mcp.* — pristup AI-agentu transportu Model Context Protocol, koji se obezbeđuje zasebno i samo za machine-to-machine klijente.
• Scope-ovi administratorskog nivoa (administrator.*) — pristup na nivou platforme koji se ne dodeljuje po aplikaciji.

Kada je aplikacija kreirana, i ova kartica i Aplikacije sa pristankom prikazuju dodeljene scope-ove grupisane po sekcijama (npr. “Rezervacije: booking.read”), tako da možete na prvi pogled videti šta aplikacija može da radi bez otvaranja.

Rotiranje kredencijala

Ako je klijentski tajni ključ možda procurio, ili želite nove kredencijale, rotirajte ih umesto da ponovo kreirate aplikaciju:

1. Pronađite aplikaciju na listi i kliknite Rotiraj.
2. Potvrdite dijalog — trenutni Client ID i tajni ključ odmah prestaju da važe.
3. Kopirajte novi Client ID i tajni ključ iz jednokratnog dijaloga pre nego što ga zatvorite.

Rotiranje čuva ime aplikacije, tip klijenta, redirect URI-jeve i scope-ove — menjaju se samo kredencijali.

Uklanjanje aplikacije

Caution

Molimo vas da ne brišete aplikaciju koju smo automatski kreirali za vas kako bismo osigurali da sve funkcije rade za vaš nalog.

Ako vam aplikacija više nije potrebna, možete je ukloniti. Ovo je trajno — kredencijali se odmah opozivaju i ne mogu se povratiti.

1. Pronađite aplikaciju na listi i kliknite Obriši.
2. Potvrdite dijalog da trajno obrišete aplikaciju.