Preskočiť na obsah

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šíriť 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 vlastnej webovej stránky alebo aplikácie.

Ukážková aplikácia
Ukážkový záznam aplikácie
  1. Vyberte účet, s ktorým chcete pracovať, na stránke Účty.
  2. Kliknite na Akcie v spodnej časti karty účtu a vyberte Spravovať účet.
  3. Na nasledujúcej stránke kliknite na kartu Aplikácie.
  4. Táto sekcia zobrazí všetky vaše aplikácie.
  5. Otočte alebo odstráňte existujúcu aplikáciu, alebo vytvorte novú.

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.

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ľúč (authorization code flow).
  • Single-page app (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 refresh tokenmi.
  • Machine-to-machine — Backendová služba, ktorá koná sama za seba (client credentials); bez prihlasovania používateľa.

Tu sú kroky na vytvorenie aplikácie:

  1. Na stránke aplikácií kliknite na tlačidlo Vytvoriť novú aplikáciu.
  2. Názov Pomenujte svoju aplikáciu. napr. Cool App
  3. Typ klienta Vyberte typ, ktorý zodpovedá spôsobu overovania vašej aplikácie — pozrite si Typy klientov vyššie.
  4. Redirect URI Vyžaduje sa aspoň jedna redirect URI. Používa sa na overenie domény presmerovania po úspešnom overení. Nepoužíva sa pre Machine-to-machine aplikácie. napr. https://www.cool-site.com
  5. Post-logout redirect URI (Voliteľné) URL adresy, kam môžu byť používatelia presmerovaní po odhlásení. Nechajte prázdne, ak chcete použiť rovnaké redirect URI ako vyššie.
  6. Scopes Vyberte, k čomu môže táto aplikácia pristupovať vo vašom mene — pozrite si Výber scopes nižšie.
  7. 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 Client ID a Client secret. 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 otočiť pre nový).

Každá aplikácia vždy obsahuje Sign-in (OpenID Connect) scopes (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 sú voliteľné.

Všetko ostatné je voliteľné. Zvyšné scopes sú rozdelené do rovnakých funkčných sekcií, ako sú zdokumentované v Scopes — Účet, Inventár a ceny, Rezervácie, Marketing a promo akcie, Obsah nehnuteľnosti, Analytika a reporty, Integrácie s channel managerom, Platby a Účtovníctvo a kniha — každá so zrozumiteľným popisom toho, čo odomyká. Použite linky Všetky / Žiadne nad zoznamom na výber alebo zrušenie všetkých voliteľných scopes naraz.

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

  • mcp.* — prístup AI-agenta k transportu Model Context Protocol. Pre ne nevytvárate aplikáciu: AI klient ako Claude, ChatGPT alebo Codex sa zaregistruje sám a žiada tieto scopes pri prihlásení cez MCP súhlasné okno. Nikdy sa nepridelia machine-to-machine aplikáciám, pretože MCP vždy koná v mene prihláseného používateľa.
  • Scopes na úrovni administrátora (administrator.*) — prístup na úrovni platformy, ktorý sa nepridáva na úrovni aplikácie.

Po vytvorení aplikácie táto karta aj Súhlasné aplikácie zobrazujú pridelené scopes zoskupené podľa sekcií (napr. “Rezervácie: booking.read”), takže na prvý pohľad vidíte, čo aplikácia dokáže, bez nutnosti ju otvárať.

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

  1. Nájdite aplikáciu v zozname a kliknite na Otočiť.
  2. Potvrďte dialóg — aktuálne Client ID a tajný kľúč prestanú okamžite fungovať.
  3. Skopírujte nové Client ID a tajný kľúč z jednorazového dialógu pred jeho zatvorením.

Otočenie zachová názov aplikácie, typ klienta, redirect URI a scopes — menia sa iba poverenia.

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

  1. Nájdite aplikáciu v zozname a kliknite na Odstrániť.
  2. Potvrďte dialóg na trvalé odstránenie aplikácie.