Sovellukset

Sovellukset antavat sinulle kehittäjänä pääsyn kaikkiin Wink:n ominaisuuksiin. Voit käyttää kaikkia samoja tietoja ja jopa laajentaa Wink:n omia ominaisuuksia. Voit valita käyttää Wink:n OAuth2-palvelinta matkailusivustosi todentamiseen samalla tavalla kuin käyttäisit Googlea tai Facebookia. Näin voit laajentaa Wink:n ominaisuuksia omalle verkkosivustollesi tai sovellukseesi.

Esimerkkisovellus — *Esimerkkisovelluksen merkintä*

Valitse tili, jonka kanssa haluat työskennellä, Tilit -sivulta.
Klikkaa tilikortin alareunasta Toiminnot ja valitse Hallitse tiliä.
Klikkaa seuraavalla sivulla Sovellukset-välilehteä.
Tässä osiossa näet kaikki sovelluksesi.
Kierrä tai poista olemassa oleva sovellus tai luo uusi.

Luo sovellus

Koska et voi käyttää meille luodun sovelluksen salaisuutta, sinun täytyy luoda oma. Voit luoda sovelluksen täällä ilman, että sinun tarvitsee ensin määrittää kiinteistöä tai yritystä — se ei ole sidottu mihinkään tiettyyn tiliin.

Asiakastyypit

Sovellusta luodessasi valitset asiakastyypin, joka määrittää, miten sovellus todentaa käyttäjän. Tätä ei voi muuttaa myöhemmin — jos tarvitset toisen tyypin, luo uusi sovellus.

Verkkosovellus — Palvelinrenderöity sovellus, joka voi turvallisesti säilyttää asiakassalaisuuden (valtuutuskoodivirtaus).
Yhden sivun sovellus (SPA) — Selainpohjainen sovellus ilman backendia; käyttää PKCE:tä ilman asiakassalaisuutta.
Mobiilisovellus — Natiivisovellus iOS:lle/Androidille; käyttää PKCE:tä kiertävillä päivitystunnuksilla.
Kone-koneelle — Backend-palvelu, joka toimii itsenäisesti (asiakastunnukset); ei käyttäjän kirjautumista.

Tässä ovat vaiheet sovelluksen luomiseen:

Sovellussivulla klikkaa Luo uusi sovellus -painiketta.
Nimi Anna sovelluksellesi nimi. esim. Cool App
Asiakastyyppi Valitse tyyppi, joka vastaa sovelluksesi todentamistapaa — katso Asiakastyypit yllä.
Uudelleenohjaus-URI:t Vähintään yksi uudelleenohjaus-URI vaaditaan. Sitä käytetään uudelleenohjausalueen vahvistamiseen onnistuneen todentamisen jälkeen. Ei käytössä kone-koneelle -sovelluksissa. esim. https://www.cool-site.com
Uloskirjautumisen jälkeiset uudelleenohjaus-URI:t (Valinnainen) URL-osoitteet, joihin käyttäjät voidaan ohjata uloskirjautumisen jälkeen. Jätä tyhjäksi käyttääksesi yllä olevia uudelleenohjaus-URI:ita.
Oikeudet Valitse, mihin tämä sovellus voi käyttää puolestasi — katso Oikeuksien valinta alla.
Klikkaa Luo sovellus jatkaaksesi.

Sinut ohjataan takaisin sovelluslistallesi, ja kertaluonteinen valintaikkuna näyttää uuden Client ID:n ja Client secretin. Kopioi salaisuus nyt ja tallenna se turvallisesti — sitä ei näytetä enää uudelleen, eikä sitä voi myöhemmin hakea (voit vain kierrättää sen uudeksi).

Oikeuksien valinta

Jokainen sovellus sisältää aina Kirjautuminen (OpenID Connect) -oikeudet (openid, profile, email, offline_access) — nämä vahvistavat käyttäjän identiteetin ja pitävät hänet kirjautuneena, joten ne näkyvät valittuina ja lukittuina; niitä ei voi poistaa.

Kaikki muu on valinnaista. Loput oikeudet on ryhmitelty samoihin toiminnallisiin osioihin, joita on kuvattu Oikeudet -sivulla — Tili, Varasto & hinnat, Varaukset, Markkinointi & kampanjat, Kiinteistön sisältö, Analytiikka & raportit, Kanavahallinnan integraatiot, Maksut sekä Kirjanpito & pääkirja — jokaisella on selkokielinen kuvaus siitä, mitä se avaa. Käytä Kaikki / Ei mitään -linkkejä listan yläpuolella valitaksesi tai poistaaksesi kaikki valinnaiset oikeudet kerralla.

Kaksi oikeusperhettä ei ole tarkoituksella tarjolla tässä lomakkeessa:

mcp.* — AI-agentin pääsy Model Context Protocol -protokollaan, joka on määritetty erikseen ja vain kone-koneelle -asiakkaille.
Ylläpitäjätason oikeudet (administrator.*) — alustan tason pääsy, jota ei myönnetä sovelluskohtaisesti.

Kun sovellus on luotu, sekä tämä välilehti että Hyväksytyt sovellukset näyttävät sen myönnetyt oikeudet ryhmiteltynä osioittain (esim. “Varaukset: booking.read”), joten näet yhdellä silmäyksellä, mitä sovellus voi tehdä avaamatta sitä.

Kierrä tunnistetiedot

Jos asiakassalaisuus on saattanut vuotaa tai haluat vain uudet tunnistetiedot, kierrä ne luomisen sijaan:

Etsi sovellus sovelluslistaltasi ja klikkaa Kierrä.
Vahvista valintaikkuna — nykyinen Client ID ja salaisuus lakkaavat toimimasta välittömästi.
Kopioi uusi Client ID ja salaisuus kertaluonteisesta valintaikkunasta ennen sen sulkemista.

Kierrätys säilyttää sovelluksen nimen, asiakastyypin, uudelleenohjaus-URI:t ja oikeudet — vain tunnistetiedot vaihtuvat.

Poista sovellus

Jos sinulla ei ole enää tarvetta sovellukselle, voit poistaa sen. Tämä on pysyvää — tunnistetiedot peruutetaan välittömästi eikä niitä voi palauttaa.

Etsi sovellus sovelluslistaltasi ja klikkaa Poista.
Vahvista valintaikkuna poistaaksesi sovelluksen pysyvästi.