Skip to content

Aplikacije

Aplikacije vam kao developeru daju pristup svim Wink značajkama. Možete pristupiti svim istim podacima i čak proširiti Winkove vlastite značajke. Možete odabrati korištenje Winkovog OAuth2 servera za autentifikaciju vaše putničke stranice na isti način kao što biste koristili Google ili Facebook. Na taj način možete proširiti Winkove značajke na vlastitu web stranicu ili aplikaciju.

Primjer aplikacije
Primjer unosa aplikacije
  1. Odaberite račun s kojim želite raditi na stranici Računi.
  2. Kliknite na Actions pri dnu kartice računa i odaberite Manage account.
  3. Kliknite na karticu Applications na sljedećoj stranici.
  4. Ovdje će biti navedene sve vaše aplikacije.
  5. Rotirajte ili izbrišite postojeću ili kreirajte novu.

Budući da ne možete pristupiti tajnom ključu aplikacije koju smo kreirali za vas, morat ćete kreirati vlastitu. Aplikaciju možete kreirati ovdje bez prethodnog postavljanja nekretnine ili tvrtke — nije vezana za određeni račun.

Prilikom kreiranja aplikacije birate vrstu klijenta koja određuje kako se aplikacija autentificira. To se kasnije ne može mijenjati — ako vam treba druga vrsta, kreirajte novu aplikaciju.

  • Web aplikacija — Server-renderirana aplikacija koja može sigurno čuvati klijentsku tajnu (authorization code flow).
  • Single-page app (SPA) — Aplikacija u pregledniku bez backend-a; koristi PKCE, bez klijentske tajne.
  • Mobilna aplikacija — Nativna iOS/Android aplikacija; koristi PKCE s rotirajućim refresh tokenima.
  • Machine-to-machine — Backend servis koji djeluje samostalno (client credentials); bez prijave korisnika.

Evo koraka za kreiranje aplikacije:

  1. Na stranici aplikacija kliknite gumb Create new application.
  2. Ime Dajte svojoj aplikaciji ime. npr. Cool App
  3. Vrsta klijenta Odaberite vrstu koja odgovara načinu autentifikacije vaše aplikacije — pogledajte Vrste klijenata gore.
  4. Redirect URI-jevi Potreban je barem jedan redirect URI. Koristi se za validaciju domene preusmjeravanja nakon uspješ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 se korisnici mogu preusmjeriti nakon odjave. Ostavite prazno za ponovno korištenje gore navedenih redirect URI-jeva.
  6. Scopes Odaberite što ova aplikacija može pristupiti u vaše ime — pogledajte Odabir scopeova dolje.
  7. Kliknite gumb Create application za nastavak.

Bit ćete preusmjereni natrag na popis aplikacija, a jednom će se prikazati dijalog s novim Client ID-jem i Client secretom. Kopirajte tajnu sada i spremite je na sigurno mjesto — nikada se više ne prikazuje i nema načina da je kasnije dohvatite (možete je samo rotirati za novu).

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

Sve ostalo je opcionalno. Preostali scopeovi su grupirani u iste funkcionalne sekcije dokumentirane u Scopes — Račun, Inventar i cijene, Rezervacije, Marketing i promocije, Sadržaj nekretnine, Analitika i izvještaji, Integracije channel managera, Plaćanja i Knjigovodstvo i evidencija — svaki sa opisom na običnom jeziku što otključava. Koristite poveznice All / None iznad liste za odabir ili poništavanje svih opcionalnih scopeova odjednom.

Dvije skupine scopeova namjerno nisu ponuđene u ovom obrascu:

  • mcp.* — pristup AI-agentu transportu Model Context Protocol. Ne kreirate aplikaciju za to: AI klijent poput Claudea, ChatGPT-a ili Codexa registrira se sam i traži ove scopeove prilikom prijave kroz MCP ekran za suglasnost. Nikada se ne dodjeljuju machine-to-machine aplikacijama jer MCP uvijek djeluje u ime prijavljenog korisnika.
  • Scopeovi razine administratora (administrator.*) — pristup na razini platforme koji se ne dodjeljuje po aplikaciji.

Nakon što je aplikacija kreirana, i ova kartica i Consented Apps prikazuju njene dodijeljene scopeove grupirane po sekcijama (npr. “Rezervacije: booking.read”), tako da na prvi pogled možete vidjeti što aplikacija može bez otvaranja.

Ako je klijentska tajna možda procurila ili želite nove vjerodajnice, rotirajte ih umjesto ponovnog kreiranja aplikacije:

  1. Pronađite aplikaciju na popisu i kliknite Rotate.
  2. Potvrdite dijalog — trenutni Client ID i tajna odmah prestaju raditi.
  3. Kopirajte novi Client ID i tajnu iz jednokratnog dijaloga prije nego ga zatvorite.

Rotiranje zadržava ime aplikacije, vrstu klijenta, redirect URI-jeve i scopeove — mijenjaju se samo vjerodajnice.

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

  1. Pronađite aplikaciju na popisu i kliknite Delete.
  2. Potvrdite dijalog za trajno brisanje aplikacije.