Aplikácie

Aplikácie vám ako vývojárovi umožňujú prístup ku všetkým funkciám Wink. Môžete pristupovať ku všetkým rovnakým údajom a dokonca rozširovať vlastné funkcie Wink. Môžete si zvoliť použitie Wink OAuth2 servera na overenie vašej cestovnej stránky rovnakým spôsobom, ako by ste použili Google alebo Facebook. Týmto spôsobom môžete rozšíriť funkcie Wink do svojej vlastnej webovej stránky alebo aplikácie.

Ukážková aplikácia — *Ukážkový záznam aplikácie*

Vyberte účet, s ktorým chcete pracovať, z Účty.
Kliknite na Akcie v spodnej časti karty účtu a vyberte Spravovať účet.
Kliknite na kartu Aplikácie na nasledujúcej stránke.
Táto sekcia zobrazí všetky vaše aplikácie.
Obnovte alebo odstráňte existujúcu aplikáciu, alebo vytvorte novú.

Vytvoriť aplikáciu

Keďže nemáte prístup k tajnému kľúču aplikácie, ktorú sme pre vás vytvorili, budete si musieť vytvoriť vlastnú. Aplikáciu môžete vytvoriť tu bez predchádzajúceho nastavenia nehnuteľnosti alebo spoločnosti — nie je viazaná na žiadny konkrétny účet.

Typy klientov

Pri vytváraní aplikácie si vyberiete typ klienta, ktorý určuje, ako sa aplikácia overuje. Toto sa neskôr nedá zmeniť — ak potrebujete iný typ, vytvorte novú aplikáciu.

Webová aplikácia — Serverom renderovaná aplikácia, ktorá môže bezpečne uchovávať klientsky tajný kľúč (priebeh autorizácie pomocou kódu).
Jednostránková aplikácia (SPA) — Prehliadačová aplikácia bez backendu; používa PKCE, bez klientskeho tajného kľúča.
Mobilná aplikácia — Nativná iOS/Android aplikácia; používa PKCE s rotujúcimi obnovovacími tokenmi.
Stroj-stroju — Backendová služba, ktorá koná sama za seba (klientské poverenia); bez prihlasovania používateľa.

Tu sú kroky na vytvorenie aplikácie:

Na stránke aplikácií kliknite na tlačidlo Vytvoriť novú aplikáciu.
Názov Pomenujte svoju aplikáciu. napr. Cool App
Typ klienta Vyberte typ, ktorý zodpovedá spôsobu overenia vašej aplikácie — pozrite si Typy klientov vyššie.
Presmerovacie URI Vyžaduje sa aspoň jedno presmerovacie URI. Používa sa na overenie domény presmerovania po úspešnom overení. Nepoužíva sa pre aplikácie stroj-stroju. napr. https://www.cool-site.com
Presmerovacie URI po odhlásení (Voliteľné) URL adresy, kam môžu byť používatelia presmerovaní po odhlásení. Nechajte prázdne, ak chcete použiť rovnaké URI ako vyššie.
Rozsahy Vyberte, k čomu môže táto aplikácia pristupovať vo vašom mene — pozrite si Výber rozsahov nižšie.
Kliknite na tlačidlo Vytvoriť aplikáciu pre pokračovanie.

Budete presmerovaní späť na zoznam svojich aplikácií a zobrazí sa jednorazový dialóg s novým ID klienta a tajným kľúčom klienta. Skopírujte si tajný kľúč teraz a uložte ho na bezpečné miesto — už nikdy sa nezobrazí a nie je možné ho neskôr získať (iba obnoviť na nový).

Výber rozsahov

Každá aplikácia vždy obsahuje Prihlásenie (OpenID Connect) rozsahy (openid, profile, email, offline_access) — tieto potvrdzujú identitu používateľa a udržiavajú ho prihláseného, preto sú zobrazené zaškrtnuté a uzamknuté; nie je to voľba.

Všetko ostatné je voliteľné. Zvyšné rozsahy sú rozdelené do rovnakých funkčných sekcií zdokumentovaných v Rozsahy — Účet, Inventár a ceny, Rezervácie, Marketing a propagácie, Obsah nehnuteľnosti, Analytika a reporty, Integrácie správcu kanálov, Platby a Účtovníctvo a kniha — každá so zrozumiteľným popisom, čo odomyká. Použite odkazy Všetko / Žiadne nad zoznamom na výber alebo zrušenie všetkých voliteľných rozsahov naraz.

Dve skupiny rozsahov nie sú v tomto formulári zámerne ponúkané:

mcp.* — Prístup AI-agenta k Model Context Protocol transportu, ktorý je poskytovaný samostatne a iba pre klientov stroj-stroju.
Rozsahy úrovne administrátora (administrator.*) — prístup na úrovni platformy, ktorý sa neudeľuje na úrovni aplikácie.

Po vytvorení aplikácie táto karta aj Schválené aplikácie zobrazujú jej udelené rozsahy zoskupené podľa sekcií (napr. “Rezervácie: booking.read”), takže môžete na prvý pohľad vidieť, čo aplikácia dokáže, bez jej otvárania.

Obnova poverení

Ak sa mohol klientsky tajný kľúč dostať von, alebo chcete len nové poverenia, obnovte ich namiesto vytvárania novej aplikácie:

Nájdite aplikáciu vo svojom zozname aplikácií a kliknite na Obnoviť.
Potvrďte dialóg — aktuálne ID klienta a tajný kľúč okamžite prestanú fungovať.
Skopírujte nové ID klienta a tajný kľúč z jednorazového dialógu pred jeho zatvorením.

Obnova zachováva názov aplikácie, typ klienta, presmerovacie URI a rozsahy — menia sa iba poverenia.

Odstrániť aplikáciu

Ak už aplikáciu nepotrebujete, môžete ju odstrániť. Toto je trvalé — poverenia sú okamžite zrušené a nie je možné ich obnoviť.

Nájdite aplikáciu vo svojom zozname aplikácií a kliknite na Odstrániť.
Potvrďte dialóg na trvalé odstránenie aplikácie.