Aplikacje
Aplikacje dają Ci dostęp do wszystkich funkcji Wink jako deweloper. Możesz uzyskać dostęp do tych samych danych, a nawet rozszerzać funkcje Wink. Możesz wybrać użycie serwera OAuth2 Wink do uwierzytelniania swojej strony podróżniczej tak samo, jak używasz Google lub Facebooka. Dzięki temu możesz rozszerzyć funkcje Wink na własną stronę internetową lub aplikację.
- Wybierz konto, z którym chcesz pracować, z Accounts.
- Kliknij
Actionsna dole karty konta i wybierzManage account. - Kliknij zakładkę
Applicationsna następnej stronie. - Ta sekcja wyświetli wszystkie Twoje aplikacje.
- Odśwież lub usuń istniejącą, albo utwórz nową.
Utwórz aplikację
Dział zatytułowany „Utwórz aplikację”Ponieważ nie masz dostępu do secret key aplikacji, którą dla Ciebie utworzyliśmy, musisz stworzyć własną.
Możesz utworzyć aplikację tutaj bez wcześniejszego zakładania nieruchomości lub firmy — nie jest ona powiązana
z żadnym konkretnym kontem.
Typy klientów
Dział zatytułowany „Typy klientów”Podczas tworzenia aplikacji wybierasz typ klienta, który określa sposób uwierzytelniania aplikacji. Nie można tego później zmienić — jeśli potrzebujesz innego typu, utwórz nową aplikację.
- Web application — Aplikacja renderowana po stronie serwera, która może bezpiecznie przechowywać sekret klienta (authorization code flow).
- Single-page app (SPA) — Aplikacja przeglądarkowa bez backendu; używa PKCE, bez sekretu klienta.
- Mobile app — Natywna aplikacja iOS/Android; używa PKCE z rotującymi tokenami odświeżania.
- Machine-to-machine — Usługa backendowa działająca jako ona sama (client credentials); bez logowania użytkownika.
Oto kroki tworzenia aplikacji:
- Na stronie aplikacji kliknij przycisk
Create new application. - Nazwa Nadaj aplikacji nazwę. np. Cool App
- Typ klienta Wybierz typ odpowiadający sposobowi uwierzytelniania aplikacji — zobacz Typy klientów powyżej.
- Redirect URIs Wymagany jest co najmniej jeden URI przekierowania. Służy do weryfikacji domeny przekierowania po pomyślnym uwierzytelnieniu. Nie jest używany dla aplikacji Machine-to-machine. np. https://www.cool-site.com
- Post-logout redirect URIs (Opcjonalne) Adresy URL, na które użytkownicy mogą być przekierowani po wylogowaniu. Pozostaw puste, aby ponownie użyć powyższych URI przekierowania.
- Scopes Wybierz, do czego ta aplikacja może mieć dostęp w Twoim imieniu — zobacz Wybór zakresów poniżej.
- Kliknij przycisk
Create application, aby kontynuować.
Zostaniesz przekierowany z powrotem do listy aplikacji, a jednorazowe okno dialogowe pokaże nowy Client ID i Client secret. Skopiuj sekret teraz i zapisz go w bezpiecznym miejscu — nie będzie już więcej wyświetlany, a nie ma możliwości jego późniejszego odzyskania (możesz go tylko obrócić na nowy).
Wybór zakresów
Dział zatytułowany „Wybór zakresów”Każda aplikacja zawsze zawiera zakresy Sign-in (OpenID Connect) (openid, profile,
email, offline_access) — potwierdzają one tożsamość użytkownika i utrzymują jego zalogowanie, dlatego są
zaznaczone i zablokowane; nie można ich wybrać.
Wszystko inne jest opcjonalne. Pozostałe zakresy są pogrupowane w te same funkcjonalne sekcje
opisane w Scopes — Konto, Inwentarz i stawki, Rezerwacje,
Marketing i promocje, Treści nieruchomości, Analizy i raporty, Integracje z channel managerami,
Płatności oraz Księgowość i rejestry — każda z prostym opisem, co odblokowuje. Użyj
linków All / None nad listą, aby zaznaczyć lub odznaczyć wszystkie opcjonalne zakresy naraz.
Dwie rodziny zakresów są celowo nie oferowane na tym formularzu:
mcp.*— dostęp agenta AI do transportu Model Context Protocol. Nie tworzysz dla nich aplikacji: klient AI taki jak Claude, ChatGPT czy Codex rejestruje się sam i żąda tych zakresów podczas logowania przez ekran zgody MCP. Nigdy nie są przyznawane aplikacjom machine-to-machine, ponieważ MCP zawsze działa w imieniu zalogowanego użytkownika.- Zakresy na poziomie administratora (
administrator.*) — dostęp na poziomie platformy, który nie jest przyznawany per aplikacja.
Po utworzeniu aplikacji zarówno ta zakładka, jak i Consented Apps pokazują przyznane zakresy
pogroupowane według sekcji (np. “Rezerwacje: booking.read”), dzięki czemu możesz szybko zobaczyć, co aplikacja może robić bez jej otwierania.
Obróć dane uwierzytelniające
Dział zatytułowany „Obróć dane uwierzytelniające”Jeśli sekret klienta mógł wyciec lub po prostu chcesz mieć nowe dane uwierzytelniające, obróć je zamiast tworzyć aplikację od nowa:
- Znajdź aplikację na liście i kliknij
Rotate. - Potwierdź dialog — obecny Client ID i sekret przestają działać natychmiast.
- Skopiuj nowy Client ID i sekret z jednorazowego okna dialogowego przed jego zamknięciem.
Obrót zachowuje nazwę aplikacji, typ klienta, URI przekierowania i zakresy — zmieniają się tylko dane uwierzytelniające.
Usuń aplikację
Dział zatytułowany „Usuń aplikację”Jeśli nie potrzebujesz już aplikacji, możesz ją usunąć. Jest to operacja trwała — dane uwierzytelniające są natychmiast unieważniane i nie można ich odzyskać.
- Znajdź aplikację na liście i kliknij
Delete. - Potwierdź dialog, aby trwale usunąć aplikację.
