Aplikacije

Aplikacije vam kot razvijalcu omogočajo dostop do vseh funkcij Wink. Dostopate lahko do vseh istih podatkov in celo razširite Winkove lastne funkcije. Lahko se odločite za uporabo Winkovega OAuth2 strežnika za preverjanje pristnosti vaše potovalne strani na enak način, kot bi uporabili Google ali Facebook. Na ta način lahko razširite Winkove funkcije na svojo lastno spletno stran ali aplikacijo.

Note

Vaša prva aplikacija je že ustvarjena, ko ustvarite nov račun. To aplikacijo uporabljamo za nekatere scenarije rezervacij.

Te aplikacije ne morete ponovno uporabiti. Prosimo, ustvarite nove aplikacije po potrebi.

Vnos primerne aplikacije

Note

Aplikacija, ustvarjena na Wink, se lahko uporablja za vse API končne točke.

1. Izberite račun, s katerim želite delati, na strani Računi.
2. Kliknite na Dejanja na dnu kartice računa in izberite Upravljaj račun.
3. Kliknite zavihek Aplikacije na naslednji strani.
4. Ta razdelek bo prikazal vse vaše aplikacije.
5. Zamenjajte ali izbrišite obstoječo aplikacijo ali ustvarite novo.

Ustvarjanje aplikacije

Ker ne morete dostopati do skrivnega ključa aplikacije, ki smo jo ustvarili za vas, boste morali ustvariti svojo lastno. Aplikacijo lahko ustvarite tukaj, ne da bi najprej nastavili nepremičnino ali podjetje — ni vezana na noben določen račun.

Vrste odjemalcev

Pri ustvarjanju aplikacije izberete vrsto odjemalca, ki določa, kako se aplikacija preverja. To ni mogoče kasneje spremeniti — če potrebujete drugačno vrsto, ustvarite novo aplikacijo.

• Spletna aplikacija — Aplikacija, ki se izvaja na strežniku in lahko varno hrani skrivni ključ odjemalca (avtorizacijski tok kode).
• Enostranska aplikacija (SPA) — Brskalniška aplikacija brez strežniške podpore; uporablja PKCE, brez skrivnega ključa odjemalca.
• Mobilna aplikacija — Nativna iOS/Android aplikacija; uporablja PKCE z rotirajočimi osvežitvenimi žetoni.
• Stroj-stroj — Strežniška storitev, ki deluje kot sama (podatki o poverilnicah odjemalca); brez prijave uporabnika.

Tukaj so koraki za ustvarjanje aplikacije:

1. Na strani aplikacij kliknite gumb Ustvari novo aplikacijo.
2. Ime Dajte svoji aplikaciji ime. npr. Cool App
3. Vrsta odjemalca Izberite vrsto, ki ustreza načinu preverjanja vaše aplikacije — glejte Vrste odjemalcev zgoraj.
4. Preusmeritveni URI-ji Zahtevan je vsaj en preusmeritveni URI. Uporablja se za preverjanje domene preusmeritve po uspešni avtentikaciji. Ni uporabljen za aplikacije stroj-stroj. npr. https://www.cool-site.com
5. Preusmeritveni URI-ji po odjavi (neobvezno) URL-ji, kamor se uporabniki preusmerijo po odjavi. Pustite prazno, da ponovno uporabite zgornje preusmeritvene URI-je.
6. Obsegi Izberite, do česa lahko ta aplikacija dostopa v vašem imenu — glejte Izbira obsegov spodaj.
7. Kliknite gumb Ustvari aplikacijo za nadaljevanje.

Preusmerjeni boste nazaj na seznam svojih aplikacij, kjer se bo prikazalo enkratno okno z novim ID-jem odjemalca in skrivnim ključem odjemalca. Zdaj kopirajte skrivni ključ in ga shranite na varno mesto — nikoli več ne bo prikazan, in ni načina, da bi ga kasneje pridobili (lahko ga le zamenjate za novega).

Izbira obsegov

Vsaka aplikacija vedno nosi obsege Prijava (OpenID Connect) (openid, profile, email, offline_access) — ti potrjujejo identiteto uporabnika in ga ohranjajo prijavljenega, zato so prikazani kot označeni in zaklenjeni; niso izbira.

Vse ostalo je opcijsko. Preostali obsegi so razdeljeni v iste funkcionalne razdelke, dokumentirane v Obsegi — Račun, Inventar in cene, Rezervacije, Marketing in promocije, Vsebina nepremičnin, Analitika in poročila, Integracije upravljalca kanalov, Plačila ter Računovodstvo in knjigovodstvo — vsak z opisom v običajnem jeziku, kaj omogoča. Uporabite povezavi Vse / Nič nad seznamom, da izberete ali počistite vse opcijske obsege naenkrat.

Note

Plačila in Računovodstvo in knjigovodstvo so označeni kot Občutljivi, ker varujejo denarne tokove — dodeljujte jih le aplikacijam, ki jih specifično potrebujejo za delo s plačili ali knjigovodstvom.

Dve skupini obsegov nista na voljo v tem obrazcu:

• mcp.* — dostop AI-agenta do Model Context Protocol transporta, ki je urejen ločeno in samo za aplikacije stroj-stroj.
• Obsegi na ravni skrbnika (administrator.*) — dostop na ravni platforme, ki ni dodeljen po aplikaciji.

Ko je aplikacija ustvarjena, ta zavihek in Dovoljene aplikacije prikazujeta njene dodeljene obsege po razdelkih (npr. “Rezervacije: booking.read”), tako da lahko na prvi pogled vidite, kaj aplikacija zmore, brez da jo odprete.

Zamenjava poverilnic

Če obstaja sum, da je skrivni ključ odjemalca ušel, ali pa želite preprosto nove poverilnice, jih zamenjajte namesto da ustvarjate novo aplikacijo:

1. Poiščite aplikacijo na seznamu in kliknite Zamenjaj.
2. Potrdite pogovorno okno — trenutni ID odjemalca in skrivni ključ takoj prenehata delovati.
3. Pred zaprtjem pogovornega okna kopirajte novi ID odjemalca in skrivni ključ iz enkratnega prikaza.

Zamenjava ohrani ime aplikacije, vrsto odjemalca, preusmeritvene URI-je in obsege — spremeni se le poverilnica.

Odstranitev aplikacije

Caution

Prosimo, ne brišite aplikacije, ki smo jo samodejno ustvarili za vas, da zagotovimo delovanje vseh funkcij za vaš račun.

Če aplikacije ne potrebujete več, jo lahko odstranite. To je trajno — poverilnice so takoj preklicane in jih ni mogoče obnoviti.

1. Poiščite aplikacijo na seznamu in kliknite Izbriši.
2. Potrdite pogovorno okno za trajno brisanje aplikacije.