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 omaan verkkosivustoosi tai sovellukseesi.
- Valitse työskentelemäsi tili Tilit -sivulta.
- Klikkaa tilikortin alareunasta
Toiminnotja valitseHallitse tiliä. - Klikkaa seuraavalla sivulla
Sovellukset-välilehteä. - Tässä osiossa näkyvät kaikki sovelluksesi.
- Kierrä tai poista olemassa oleva sovellus tai luo uusi.
Luo sovellus
Osio nimeltä “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
Osio nimeltä “Asiakastyypit”Kun luot sovellusta, 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 yllä Asiakastyypit.
- 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
- Uudelleenohjaus-URI:t uloskirjautumisen jälkeen (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 alla Oikeuksien valinta.
- Klikkaa
Luo sovellusjatkaaksesi.
Sinut ohjataan takaisin sovelluslistallesi, ja kertaluonteinen valintaikkuna näyttää uuden Asiakas-ID:n ja Asiakassalaisuuden. Kopioi salaisuus nyt ja tallenna se turvalliseen paikkaan — sitä ei näytetä enää uudelleen, eikä sitä voi myöhemmin hakea (voit vain kierrättää sen uudeksi).
Oikeuksien valinta
Osio nimeltä “Oikeuksien valinta”Jokaisella sovelluksella on aina mukana 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, jotka on dokumentoitu 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ä ne avaavat. 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 -kuljetukseen. Et luo sovellusta tätä varten: AI-asiakas kuten Claude, ChatGPT tai Codex rekisteröityy itse ja pyytää näitä oikeuksia kirjautuessasi MCP:n suostumusnäytön kautta. Niitä ei koskaan myönnetä kone-koneelle -sovelluksille, koska MCP toimii aina kirjautuneen käyttäjän puolesta.- 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 ryhmiteltyinä osioittain (esim. “Varaukset: booking.read”), joten näet yhdellä silmäyksellä, mitä sovellus voi tehdä avaamatta sitä.
Kierrä tunnistetiedot
Osio nimeltä “Kierrä tunnistetiedot”Jos asiakassalaisuus on saattanut vuotaa tai haluat vain uudet tunnistetiedot, kierrä ne uuden sovelluksen luomisen sijaan:
- Etsi sovellus sovelluslistaltasi ja klikkaa
Kierrä. - Vahvista valintaikkuna — nykyinen Asiakas-ID ja salaisuus lakkaavat toimimasta välittömästi.
- Kopioi uusi Asiakas-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
Osio nimeltä “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.
