Alkalmazások
Az alkalmazások hozzáférést biztosítanak a Wink összes funkciójához fejlesztőként. Hozzáférhet ugyanazokhoz az adatokhoz, és akár bővítheti is a Wink saját funkcióit. Választhatja, hogy a Wink OAuth2 szerverét használja utazási oldalának hitelesítésére ugyanúgy, ahogy a Google vagy a Facebook esetében. Így kiterjesztheti a Wink funkcióit a saját weboldalára vagy alkalmazására.
- Válassza ki a Fiókok oldalról azt a fiókot, amellyel dolgozni szeretne.
- Kattintson a fiókkártya alján az
Műveletekgombra, majd válassza aFiók kezeléselehetőséget. - Kattintson az
Alkalmazásokfülre a következő oldalon. - Itt megjelenik az összes alkalmazása.
- Forgassa vagy törölje a meglévőt, vagy hozzon létre újat.
Alkalmazás létrehozása
Szekció neve “Alkalmazás létrehozása”Mivel nem fér hozzá az általunk létrehozott alkalmazás titkos kulcsához, sajátot kell létrehoznia.
Itt létrehozhat egy alkalmazást anélkül, hogy először ingatlant vagy céget állítana be — nem kötődik
egy adott fiókhoz.
Ügyféltípusok
Szekció neve “Ügyféltípusok”Alkalmazás létrehozásakor ki kell választania egy ügyféltípust, amely meghatározza, hogyan hitelesíti az alkalmazás magát. Ezt később nem lehet megváltoztatni — ha más típusra van szüksége, hozzon létre új alkalmazást.
- Webalkalmazás — Szerveroldalon renderelt alkalmazás, amely biztonságosan tárolhat ügyfél titkot (engedélyezési kód folyamat).
- Egylapos alkalmazás (SPA) — Böngészőben futó alkalmazás backend nélkül; PKCE-t használ, ügyfél titok nélkül.
- Mobilalkalmazás — Natív iOS/Android alkalmazás; PKCE-t használ forgó frissítő tokenekkel.
- Gép-gép közötti — Backend szolgáltatás, amely saját magaként működik (ügyfél hitelesítő adatok); nincs felhasználói bejelentkezés.
Az alkalmazás létrehozásának lépései:
- Az alkalmazások oldalán kattintson a
Új alkalmazás létrehozásagombra. - Név Adjon nevet az alkalmazásának. pl. Cool App
- Ügyféltípus Válassza ki azt a típust, amely megfelel az alkalmazás hitelesítési módjának — lásd fent a Ügyféltípusokat.
- Átirányítási URI-k Legalább egy átirányítási URI szükséges. Ezt az átirányítási domain érvényesítésére használják sikeres hitelesítés után. Gép-gép közötti alkalmazásoknál nem használatos. pl. https://www.cool-site.com
- Kijelentkezés utáni átirányítási URI-k (Opcionális) URL-ek, ahová a felhasználók kijelentkezés után átirányíthatók. Hagyja üresen, ha az előző átirányítási URI-kat szeretné újra használni.
- Jogosultságok Válassza ki, hogy az alkalmazás milyen hozzáféréseket kapjon az Ön nevében — lásd lent a Jogosultságok kiválasztása részt.
- Kattintson a
Alkalmazás létrehozásagombra a folytatáshoz.
Visszairányítják az alkalmazáslistájához, és egy egyszeri párbeszédablakban megjelenik az új Ügyfélazonosító és Ügyféltitok. Másolja ki most a titkot, és mentse biztonságos helyre — ezt soha többé nem mutatjuk meg, és később nem lehet lekérni (csak forgatni lehet újra).
Jogosultságok kiválasztása
Szekció neve “Jogosultságok kiválasztása”Minden alkalmazás mindig tartalmazza a Bejelentkezés (OpenID Connect) jogosultságokat (openid, profile,
email, offline_access) — ezek megerősítik a felhasználó személyazonosságát és bejelentkezve tartják, ezért
be vannak jelölve és zárolva; ezek nem választhatók.
Minden más opcionális. A fennmaradó jogosultságok ugyanabba a funkcionális szekciókba vannak csoportosítva,
amelyek a Jogosultságok dokumentációban szerepelnek — Fiók, Készlet és árak, Foglalások,
Marketing és promóciók, Ingatlan tartalom, Elemzések és jelentések, Csatornakezelő integrációk,
Fizetések, valamint Könyvelés és főkönyv — mindegyik egyszerű nyelven leírja, mit engedélyez. Használja
a lista feletti Mind / Egyik sem linkeket az összes opcionális jogosultság egyszerre történő kiválasztásához vagy törléséhez.
Két jogosultságcsaládot szándékosan nem kínálunk fel ezen az űrlapon:
mcp.*— AI-ügynök hozzáférés a Model Context Protocol protokollhoz. Ehhez nem hoz létre alkalmazást: egy AI kliens, mint Claude, ChatGPT vagy Codex regisztrálja magát, és kéri ezeket a jogosultságokat, amikor az MCP hozzájárulási képernyőn bejelentkezik. Ezeket soha nem adják meg gép-gép közötti alkalmazásoknak, mert az MCP mindig bejelentkezett felhasználó nevében jár el.- Adminisztrátori szintű jogosultságok (
administrator.*) — platform szintű hozzáférés, amelyet nem adnak meg alkalmazásonként.
Miután egy alkalmazás létrejött, ez a fül és a Hozzájárult alkalmazások is megmutatja a megadott jogosultságokat szekciónként csoportosítva (pl. “Foglalások: booking.read”), így egy pillantással láthatja, mit tehet egy alkalmazás anélkül, hogy megnyitná.
Hitelesítő adatok forgatása
Szekció neve “Hitelesítő adatok forgatása”Ha az ügyféltitok kiszivároghatott, vagy csak friss hitelesítő adatokra van szüksége, forgassa őket ahelyett, hogy újra létrehozná az alkalmazást:
- Keresse meg az alkalmazást az alkalmazáslistájában, és kattintson a
Forgatásgombra. - Erősítse meg a párbeszédablakot — az aktuális Ügyfélazonosító és titok azonnal érvénytelenné válik.
- Másolja ki az új Ügyfélazonosítót és titkot az egyszeri párbeszédablakból, mielőtt bezárja.
A forgatás megtartja az alkalmazás nevét, ügyféltípusát, átirányítási URI-jait és jogosultságait — csak a hitelesítő adatok változnak.
Alkalmazás eltávolítása
Szekció neve “Alkalmazás eltávolítása”Ha már nincs szüksége egy alkalmazásra, nyugodtan eltávolíthatja. Ez végleges — a hitelesítő adatok azonnal visszavonásra kerülnek, és nem állíthatók vissza.
- Keresse meg az alkalmazást az alkalmazáslistájában, és kattintson a
Törlésgombra. - Erősítse meg a párbeszédablakot az alkalmazás végleges törléséhez.
