Tovább a tartalomhoz

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.

Minta alkalmazás
Minta alkalmazás bejegyzés
  1. Válassza ki a Fiókok oldalról azt a fiókot, amellyel dolgozni szeretne.
  2. Kattintson a fiókkártya alján az Műveletek gombra, majd válassza a Fiók kezelése lehetőséget.
  3. Kattintson az Alkalmazások fülre a következő oldalon.
  4. Itt megjelenik az összes alkalmazása.
  5. Forgassa vagy törölje a meglévőt, vagy hozzon létre újat.

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.

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:

  1. Az alkalmazások oldalán kattintson a Új alkalmazás létrehozása gombra.
  2. Név Adjon nevet az alkalmazásának. pl. Cool App
  3. Ü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.
  4. Á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
  5. 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.
  6. 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.
  7. Kattintson a Alkalmazás létrehozása gombra 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).

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

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:

  1. Keresse meg az alkalmazást az alkalmazáslistájában, és kattintson a Forgatás gombra.
  2. Erősítse meg a párbeszédablakot — az aktuális Ügyfélazonosító és titok azonnal érvénytelenné válik.
  3. 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.

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.

  1. Keresse meg az alkalmazást az alkalmazáslistájában, és kattintson a Törlés gombra.
  2. Erősítse meg a párbeszédablakot az alkalmazás végleges törléséhez.