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

Przykładowa aplikacja — *Przykładowy wpis aplikacji*

Wybierz konto, z którym chcesz pracować, z Konta.
Kliknij Akcje na dole karty konta i wybierz Zarządzaj kontem.
Kliknij zakładkę Aplikacje na kolejnej stronie.
Ta sekcja wyświetli wszystkie Twoje aplikacje.
Odśwież lub usuń istniejącą, albo utwórz nową.

Utwórz aplikację

Ponieważ nie masz dostępu do sekretnego klucza 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

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

Aplikacja webowa — Aplikacja renderowana po stronie serwera, która może bezpiecznie przechowywać sekret klienta (przepływ kodu autoryzacyjnego).
Aplikacja jednostronicowa (SPA) — Aplikacja w przeglądarce bez backendu; używa PKCE, bez sekretu klienta.
Aplikacja mobilna — Natywna aplikacja iOS/Android; używa PKCE z rotującymi tokenami odświeżania.
Maszyna do maszyny — Usługa backendowa działająca jako ona sama (poświadczenia klienta); bez logowania użytkownika.

Oto kroki tworzenia aplikacji:

Na stronie aplikacji kliknij przycisk Utwórz nową aplikację.
Nazwa Nadaj aplikacji nazwę. np. Cool App
Typ klienta Wybierz typ odpowiadający sposobowi uwierzytelniania aplikacji — zobacz Typy klientów powyżej.
URI przekierowania Wymagany jest co najmniej jeden URI przekierowania. Służy do weryfikacji domeny przekierowania po pomyślnym uwierzytelnieniu. Nie dotyczy aplikacji Maszyna do maszyny. np. https://www.cool-site.com
URI przekierowania po wylogowaniu (Opcjonalne) Adresy URL, na które użytkownicy mogą być przekierowani po wylogowaniu. Pozostaw puste, aby ponownie użyć powyższych URI przekierowania.
Zakresy Wybierz, do czego ta aplikacja może mieć dostęp w Twoim imieniu — zobacz Wybór zakresów poniżej.
Kliknij przycisk Utwórz aplikację, 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 w bezpiecznym miejscu — nie będzie już więcej wyświetlany, a później nie ma możliwości jego odzyskania (możesz tylko odświeżyć na nowy).

Wybór zakresów

Każda aplikacja zawsze zawiera zakresy Logowanie (OpenID Connect) (openid, profile, email, offline_access) — potwierdzają one tożsamość użytkownika i utrzymują go zalogowanego, dlatego są zaznaczone i zablokowane; nie można ich wybrać.

Wszystko inne jest opcjonalne. Pozostałe zakresy są pogrupowane w te same sekcje funkcjonalne opisane w Zakresy — Konto, Inwentarz i stawki, Rezerwacje, Marketing i promocje, Zawartość nieruchomości, Analizy i raporty, Integracje z channel managerami, Płatności oraz Księgowość i rejestr — każda z prostym opisem, co odblokowuje. Użyj linków Wszystkie / Brak nad listą, aby zaznaczyć lub odznaczyć wszystkie opcjonalne zakresy naraz.

Dwie rodziny zakresów są celowo nie oferowane w tym formularzu:

mcp.* — dostęp agenta AI do transportu Model Context Protocol, który jest udostępniany osobno i tylko dla klientów maszyna do maszyny.
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 Zgoda aplikacji 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.

Odświeżanie poświadczeń

Jeśli sekret klienta mógł wyciec lub po prostu chcesz mieć nowe poświadczenia, odśwież je zamiast tworzyć aplikację od nowa:

Znajdź aplikację na liście i kliknij Odśwież.
Potwierdź w oknie dialogowym — obecny Client ID i sekret przestają działać natychmiast.
Skopiuj nowy Client ID i sekret z jednorazowego okna dialogowego przed jego zamknięciem.

Odświeżanie zachowuje nazwę aplikacji, typ klienta, URI przekierowania i zakresy — zmieniają się tylko poświadczenia.

Usuwanie aplikacji

Jeśli nie potrzebujesz już aplikacji, możesz ją usunąć. Jest to operacja trwała — poświadczenia są natychmiast unieważniane i nie można ich odzyskać.

Znajdź aplikację na liście i kliknij Usuń.
Potwierdź w oknie dialogowym, aby trwale usunąć aplikację.