Приложения
Приложенията ви дават достъп до всички функции на Wink като разработчик. Можете да получите достъп до всички същите данни и дори да разширите собствените функции на Wink. Можете да изберете да използвате OAuth2 сървъра на Wink, за да удостоверите вашия туристически сайт по същия начин, по който бихте използвали Google или Facebook. По този начин можете да разширите функциите на Wink във вашия собствен уебсайт или приложение.
- Изберете акаунта, с който искате да работите, от Accounts.
- Кликнете на
Actionsв долната част на картата на акаунта и изберетеManage account. - Кликнете на таба
Applicationsна следващата страница. - Този раздел ще покаже всички ваши приложения.
- Завъртете или изтрийте съществуващо приложение, или създайте ново.
Създаване на приложение
Section titled “Създаване на приложение”Тъй като не можете да получите достъп до secret key на приложението, което създадохме за вас, ще трябва да създадете свое собствено.
Можете да създадете приложение тук без първо да настройвате имот или компания — то не е обвързано
с конкретен акаунт.
Типове клиенти
Section titled “Типове клиенти”При създаване на приложение избирате тип клиент, който определя как приложението се удостоверява. Това не може да бъде променяно по-късно — ако имате нужда от друг тип, създайте ново приложение.
- Уеб приложение — Сървърно рендерирано приложение, което може безопасно да пази клиентски таен ключ (authorization code flow).
- Single-page app (SPA) — Браузърно приложение без бекенд; използва PKCE, без клиентски таен ключ.
- Мобилно приложение — Родно iOS/Android приложение; използва PKCE с въртящи се refresh токени.
- Machine-to-machine — Бекенд услуга, действаща от свое име (client credentials); без потребителско влизане.
Ето стъпките за създаване на приложение:
- От страницата с приложения кликнете бутона
Create new application. - Име Дайте име на вашето приложение. напр. Cool App
- Тип клиент Изберете типа, който съответства на начина, по който приложението ви се удостоверява — вижте Типове клиенти по-горе.
- Redirect URIs Изисква се поне един redirect URI. Той се използва за валидиране на домейна за пренасочване след успешно удостоверяване. Не се използва за Machine-to-machine приложения. напр. https://www.cool-site.com
- Post-logout redirect URIs (По избор) URL адреси, към които потребителите могат да бъдат пренасочени след излизане. Оставете празно, за да използвате отново горните redirect URIs.
- Scopes Изберете какво може да достъпва това приложение от ваше име — вижте Избор на scopes по-долу.
- Кликнете бутона
Create application, за да продължите.
Ще бъдете пренасочени обратно към списъка с приложения, а еднократен диалог ще покаже новия Client ID и Client secret. Копирайте тайната сега и я запазете на сигурно място — тя никога повече няма да бъде показана и няма начин да бъде възстановена по-късно (може само да бъде завъртяна за нова).
Избор на scopes
Section titled “Избор на scopes”Всяко приложение винаги носи Sign-in (OpenID Connect) scopes (openid, profile,
email, offline_access) — те потвърждават самоличността на потребителя и го държат влязъл, затова са
показани отметнати и заключени; те не са избор.
Всичко останало е по избор. Останалите scopes са групирани в същите функционални секции,
документирани в Scopes — Акаунт, Инвентар и цени, Резервации,
Маркетинг и промоции, Съдържание на имота, Анализи и отчети, Интеграции с Channel manager,
Плащания и Счетоводство и главна книга — всяка с описание на разбираем език какво отключва. Използвайте
връзките All / None над списъка, за да изберете или изчистите всички опционални scopes наведнъж.
Две семейства scopes умишлено не се предлагат в тази форма:
mcp.*— Достъп на AI агент до транспорта на Model Context Protocol. Не създавате приложение за това: AI клиент като Claude, ChatGPT или Codex се регистрира сам и иска тези scopes при влизане през MCP consent екрана. Те никога не се предоставят на machine-to-machine приложения, защото MCP винаги действа от името на влязъл потребител.- Scopes на ниво администратор (
administrator.*) — достъп на платформено ниво, който не се предоставя на приложение.
След като приложението е създадено, както този таб, така и Consented Apps показват предоставените му scopes, групирани по секции (напр. “Резервации: booking.read”), така че да можете да видите какво може да прави приложението с един поглед, без да го отваряте.
Завъртане на идентификационни данни
Section titled “Завъртане на идентификационни данни”Ако клиентският таен ключ може да е изтекъл, или просто искате нови идентификационни данни, завъртете ги вместо да създавате приложението наново:
- Намерете приложението в списъка си и кликнете
Rotate. - Потвърдете диалога — текущият Client ID и secret спират да работят веднага.
- Копирайте новия Client ID и secret от еднократния диалог преди да го затворите.
Завъртането запазва името на приложението, типа клиент, redirect URIs и scopes — променят се само идентификационните данни.
Премахване на приложение
Section titled “Премахване на приложение”Ако вече нямате нужда от приложение, можете да го премахнете. Това е постоянно — идентификационните данни се отнемат веднага и не могат да бъдат възстановени.
- Намерете приложението в списъка си и кликнете
Delete. - Потвърдете диалога, за да изтриете приложението окончателно.
