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.

Note

Vaša prva aplikacija je već kreirana kada stvorite novi račun. Koristimo tu aplikaciju za neke scenarije rezervacija.

Ne možete ponovno koristiti ovu aplikaciju. Molimo kreirajte nove aplikacije prema potrebi.

Primjer unosa aplikacije

Note

Aplikacija generirana na Wink može se koristiti za sve API krajnje točke.

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.

Kreirajte aplikaciju

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

Vrste klijenata

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

• Web aplikacija — Aplikacija renderirana na serveru koja može sigurno čuvati klijentski tajni ključ (authorization code flow).
• Single-page app (SPA) — Aplikacija u pregledniku bez backend-a; koristi PKCE, bez klijentskog tajnog ključa.
• Mobilna aplikacija — Izvorna 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 provjeru 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. Scope-ovi Odaberite što ova aplikacija može pristupiti u vaše ime — pogledajte Odabir scope-ova 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 tajni ključ sada i spremite ga na sigurno mjesto — nikada se više neće prikazati i nema načina da ga kasnije dohvatite (možete ga samo rotirati za novi).

Odabir scope-ova

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

Sve ostalo je opcionalno. Preostali scope-ovi 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 — svaki s opisom na običnom jeziku što otključava. Koristite poveznice All / None iznad liste za odabir ili poništavanje svih opcionalnih scope-ova odjednom.

Note

Plaćanja i Knjigovodstvo su označeni kao Osjetljivi jer štite novčane transakcije — dodjeljujte ih samo aplikacijama kojima je to specifično potrebno.

Dvije skupine scope-ova namjerno nisu ponuđene u ovom obrascu:

• mcp.* — pristup AI-agentu transportu Model Context Protocol, koji se zasebno dodjeljuje i samo za machine-to-machine klijente.
• Scope-ovi 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 dodijeljene scope-ove grupirane po sekciji (npr. “Rezervacije: booking.read”), tako da na prvi pogled možete vidjeti što aplikacija može bez otvaranja.

Rotiranje vjerodajnica

Ako je klijentski tajni ključ možda procurio ili želite nove vjerodajnice, rotirajte ih umjesto da ponovno kreirate aplikaciju:

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

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

Ukloni aplikaciju

Caution

Molimo vas da ne brišete aplikaciju koju smo automatski kreirali za vas kako bi sve značajke radile za vaš račun.

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.