Skip to content

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 sajta za putovanja 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.

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

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

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.

  • Web aplikacija — Server-renderovana aplikacija koja može bezbedno čuvati 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 Create new application.
  2. Ime Dajte ime svojoj aplikaciji. 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 Create application 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).

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

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

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

  • mcp.* — pristup AI-agentu transportu Model Context Protocol. Ne kreirate aplikaciju za to: AI klijent kao Claude, ChatGPT ili Codex se registruje sam i zahteva ove scope-ove kada se prijavite preko MCP ekrana za saglasnost. Nikada se ne dodeljuju machine-to-machine aplikacijama, jer MCP uvek deluje u ime prijavljenog korisnika.
  • Scope-ovi nivoa administratora (administrator.*) — pristup na nivou platforme koji se ne dodeljuje po aplikaciji.

Kada je aplikacija kreirana, i ova kartica i Consented Apps 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.

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

  1. Pronađite aplikaciju na listi i kliknite Rotate.
  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.

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 Delete.
  2. Potvrdite dijalog da trajno obrišete aplikaciju.