Aplikace

Aplikace vám jako vývojáři umožňují přístup ke všem funkcím Wink. Můžete získat přístup ke všem stejným datům a dokonce rozšířit vlastní funkce Wink. Můžete si zvolit použití Wink OAuth2 serveru k ověření vašeho cestovního webu stejným způsobem, jako byste použili Google nebo Facebook. Tímto způsobem můžete rozšířit funkce Wink do svého vlastního webu nebo aplikace.

Vyberte účet, se kterým chcete pracovat, na stránce Účty.
Klikněte na Akce ve spodní části karty účtu a zvolte Spravovat účet.
Na následující stránce klikněte na záložku Aplikace.
V této sekci se zobrazí všechny vaše aplikace.
Otočte nebo smažte existující aplikaci, nebo vytvořte novou.

Vytvoření aplikace

Protože nemáte přístup k tajnému klíči aplikace, kterou jsme pro vás vytvořili, budete si muset vytvořit vlastní. Aplikaci můžete vytvořit zde, aniž byste nejprve nastavovali nemovitost nebo společnost — není vázána na žádný konkrétní účet.

Typy klientů

Při vytváření aplikace si vyberete typ klienta, který určuje, jak se aplikace ověřuje. Toto nelze později změnit — pokud potřebujete jiný typ, vytvořte novou aplikaci.

Webová aplikace — Serverem vykreslovaná aplikace, která může bezpečně uchovávat klientský tajný klíč (authorization code flow).
Single-page app (SPA) — Prohlížečová aplikace bez backendu; používá PKCE, bez klientského tajného klíče.
Mobilní aplikace — Nativní iOS/Android aplikace; používá PKCE s rotujícími obnovovacími tokeny.
Machine-to-machine — Backendová služba jednající sama za sebe (client credentials); bez přihlášení uživatele.

Zde jsou kroky pro vytvoření aplikace:

Na stránce aplikací klikněte na tlačítko Vytvořit novou aplikaci.
Název Pojmenujte svou aplikaci. např. Cool App
Typ klienta Vyberte typ, který odpovídá způsobu ověřování vaší aplikace — viz Typy klientů výše.
Redirect URI Je vyžadována alespoň jedna redirect URI. Používá se k ověření domény přesměrování po úspěšném ověření. Nepoužívá se u aplikací Machine-to-machine. např. https://www.cool-site.com
Post-logout redirect URI (Volitelné) URL, kam mohou být uživatelé přesměrováni po odhlášení. Nechte prázdné pro opětovné použití výše uvedených redirect URI.
Scopes Vyberte, k čemu může tato aplikace přistupovat vaším jménem — viz Výběr scopes níže.
Klikněte na tlačítko Vytvořit aplikaci pro pokračování.

Budete přesměrováni zpět na seznam svých aplikací a jednorázový dialog zobrazí nové Client ID a Client secret. Zkopírujte si tajný klíč nyní a uložte jej na bezpečné místo — nikdy se již znovu nezobrazí a není možné jej později získat (lze jej pouze otočit pro nový).

Výběr scopes

Každá aplikace vždy obsahuje Sign-in (OpenID Connect) scopes (openid, profile, email, offline_access) — tyto potvrzují identitu uživatele a udržují ho přihlášeného, proto jsou zobrazeny zaškrtnuté a uzamčené; nejsou volitelné.

Vše ostatní je volitelné. Zbývající scopes jsou seskupeny do stejných funkčních sekcí, jak je popsáno v Scopes — Účet, Inventář a sazby, Rezervace, Marketing a propagace, Obsah nemovitosti, Analytika a reporty, Integrace s channel managerem, Platby a Účetnictví a hlavní kniha — každá s popisem v běžném jazyce, co odemyká. Použijte odkazy Vše / Žádné nad seznamem pro výběr nebo zrušení všech volitelných scopes najednou.

Dvě skupiny scopes nejsou v tomto formuláři záměrně nabízeny:

mcp.* — přístup AI-agenta k transportu Model Context Protocol, který je poskytován samostatně a pouze pro machine-to-machine klienty.
Scopes na úrovni administrátora (administrator.*) — přístup na úrovni platformy, který není udělován na úrovni aplikace.

Po vytvoření aplikace tato záložka i Schválené aplikace zobrazují její udělené scopes seskupené podle sekcí (např. “Rezervace: booking.read”), takže můžete na první pohled vidět, co aplikace umí, aniž byste ji museli otevírat.

Otočení přihlašovacích údajů

Pokud by mohl být klientský tajný klíč kompromitován, nebo chcete prostě nové přihlašovací údaje, otočte je místo vytváření nové aplikace:

Najděte aplikaci ve svém seznamu a klikněte na Otočit.
Potvrďte dialog — současné Client ID a tajný klíč přestanou okamžitě fungovat.
Zkopírujte nové Client ID a tajný klíč z jednorázového dialogu před jeho zavřením.

Otočení zachová název aplikace, typ klienta, redirect URI a scopes — mění se pouze přihlašovací údaje.

Odstranění aplikace

Pokud aplikaci již nepotřebujete, můžete ji odstranit. Toto je trvalé — přihlašovací údaje jsou okamžitě zneplatněny a nelze je obnovit.

Najděte aplikaci ve svém seznamu a klikněte na Smazat.
Potvrďte dialog pro trvalé smazání aplikace.