Приложения

Приложенията ви дават достъп до всички функции на Wink като разработчик. Можете да достъпите същите данни и дори да разширите собствените функции на Wink. Можете да изберете да използвате OAuth2 сървъра на Wink, за да удостоверите вашия туристически сайт по същия начин, по който бихте използвали Google или Facebook. По този начин можете да разширите функциите на Wink във вашия собствен уебсайт или приложение.

Примерно приложение — *Примерен запис на приложение*

Изберете акаунта, с който искате да работите, от Акаунти.
Кликнете на Действия в долната част на картата на акаунта и изберете Управление на акаунта.
Кликнете на таба Приложения на следващата страница.
Този раздел ще покаже всички ваши приложения.
Завъртете или изтрийте съществуващо приложение, или създайте ново.

Създаване на приложение

Тъй като нямате достъп до тайния ключ на приложението, което създадохме за вас, ще трябва да създадете свое собствено. Можете да създадете приложение тук без първо да настройвате имот или компания — то не е обвързано с конкретен акаунт.

Видове клиенти

При създаване на приложение избирате тип клиент, който определя как приложението се удостоверява. Това не може да се променя по-късно — ако имате нужда от друг тип, създайте ново приложение.

Уеб приложение — Сървърно рендерирано приложение, което може безопасно да пази клиентски таен ключ (authorization code flow).
Едностранично приложение (SPA) — Приложение в браузъра без бекенд; използва PKCE, без клиентски таен ключ.
Мобилно приложение — Родното iOS/Android приложение; използва PKCE с въртящи се refresh токени.
Машина към машина — Бекенд услуга, действаща сама за себе си (client credentials); без потребителско влизане.

Ето стъпките за създаване на приложение:

От страницата с приложения кликнете бутона Създай ново приложение.
Име Дайте име на вашето приложение. напр. Cool App
Тип клиент Изберете типа, който съответства на начина, по който приложението се удостоверява — вижте Видове клиенти по-горе.
Redirect URI-та Изисква се поне един redirect URI. Използва се за валидиране на домейна след успешно удостоверяване. Не се използва за приложения машина към машина. напр. https://www.cool-site.com
Post-logout redirect URI-та (По избор) URL адреси, към които потребителите могат да бъдат пренасочени след излизане. Оставете празно, за да използвате redirect URI-тата отгоре.
Обхвати (Scopes) Изберете какво може да достъпва това приложение от ваше име — вижте Избор на обхвати по-долу.
Кликнете бутона Създай приложение, за да продължите.

Ще бъдете пренасочени обратно към списъка с приложения, а еднократен диалог ще покаже новия Client ID и Client secret. Копирайте тайната сега и я запазете на сигурно място — тя никога повече няма да бъде показвана, и няма начин да бъде възстановена по-късно (може само да бъде завъртяна за нова).

Избор на обхвати

Всяко приложение винаги носи Обхвати за влизане (OpenID Connect) (openid, profile, email, offline_access) — те потвърждават самоличността на потребителя и го държат влязъл, затова са отметнати и заключени; не са избор.

Всичко останало е по избор. Останалите обхвати са групирани в същите функционални секции, описани в Обхвати — Акаунт, Инвентар и цени, Резервации, Маркетинг и промоции, Съдържание на имота, Анализи и отчети, Интеграции с Channel manager, Плащания и Счетоводство и главна книга — всяка с описание на достъпа, който отключва. Използвайте връзките Всички / Нито един над списъка, за да изберете или изчистите всички опционални обхвати наведнъж.

Два семейства обхвати умишлено не се предлагат в тази форма:

mcp.* — Достъп на AI агент до Model Context Protocol транспорта, който се предоставя отделно и само за клиенти машина към машина.
Обхвати на ниво администратор (administrator.*) — достъп на платформено ниво, който не се дава на ниво приложение.

След като приложението е създадено, както този таб, така и Одобрени приложения показват неговите дадени обхвати, групирани по секции (напр. “Резервации: booking.read”), за да можете да видите какво може да прави приложението с един поглед без да го отваряте.

Завъртане на идентификационни данни

Ако клиентският таен ключ може да е изтекъл, или просто искате нови идентификационни данни, завъртете ги вместо да създавате приложението наново:

Намерете приложението в списъка си и кликнете Завърти.
Потвърдете диалога — текущият Client ID и таен ключ спират да работят веднага.
Копирайте новия Client ID и таен ключ от еднократния диалог преди да го затворите.

Завъртането запазва името на приложението, типа клиент, redirect URI-тата и обхватите — променят се само идентификационните данни.

Премахване на приложение

Ако вече нямате нужда от приложение, можете да го премахнете. Това е постоянно — идентификационните данни се отнемат веднага и не могат да бъдат възстановени.

Намерете приложението в списъка си и кликнете Изтрий.
Потвърдете диалога, за да изтриете приложението окончателно.