Skip to content

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.

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

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.

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 kodeksni tok).
  • 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 (pooblastila 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 se ponovno uporabijo zgornji preusmeritveni URI-ji.
  6. Obsegi Izberite, do česa lahko ta aplikacija dostopa v vašem imenu — glejte Izbira obsegov spodaj.
  7. Kliknite gumb Ustvari aplikacijo, da nadaljujete.

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

Vsaka aplikacija vedno nosi Prijava (OpenID Connect) obsege (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čnine, 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.

Dve skupini obsegov nista na voljo v tem obrazcu:

  • mcp.* — Dostop AI-agenta do Model Context Protocol transporta. Za to ne ustvarjate aplikacije: AI odjemalec, kot so Claude, ChatGPT ali Codex, se registrira sam in zahteva te obsege ob prijavi prek MCP zaslona za soglasje. Nikoli niso dodeljeni aplikacijam stroj-stroj, ker MCP vedno deluje v imenu prijavljenega uporabnika.
  • Obsegi na ravni skrbnika (administrator.*) — dostop na ravni platforme, ki ni dodeljen posamezni 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 odpiranja.

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

  1. Poiščite aplikacijo na seznamu in kliknite Zamenjaj.
  2. Potrdite pogovorno okno — trenutni ID odjemalca in skrivni ključ takoj prenehata delovati.
  3. Kopirajte novi ID odjemalca in skrivni ključ iz enkratnega pogovornega okna, preden ga zaprete.

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

Č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.