Додатки
Додатки надають вам доступ до всіх функцій Wink як розробнику. Ви можете отримувати доступ до тих самих даних і навіть розширювати власні функції Wink. Ви можете обрати використання сервера OAuth2 Wink для автентифікації вашого туристичного сайту так само, як ви використовуєте Google або Facebook. Таким чином ви можете розширити функції Wink у вашому власному вебсайті або додатку.
- Виберіть акаунт, з яким хочете працювати, на сторінці Accounts.
- Натисніть
Actionsу нижній частині картки акаунта та оберітьManage account. - Натисніть вкладку
Applicationsна наступній сторінці. - У цьому розділі буде перелік усіх ваших додатків.
- Оновіть або видаліть існуючий додаток, або створіть новий.
Створення додатку
Section titled “Створення додатку”Оскільки ви не маєте доступу до секретного ключа додатку, який ми створили для вас, вам потрібно створити власний.
Ви можете створити додаток тут без попереднього налаштування власності або компанії — він не прив’язаний
до жодного конкретного акаунта.
Типи клієнтів
Section titled “Типи клієнтів”При створенні додатку ви обираєте тип клієнта, який визначає, як додаток автентифікується. Це не можна змінити пізніше — якщо потрібен інший тип, створіть новий додаток.
- Веб-додаток — серверний додаток, який може безпечно зберігати секрет клієнта (потік авторизації з кодом).
- Односторінковий додаток (SPA) — браузерний додаток без бекенду; використовує PKCE, без секрету клієнта.
- Мобільний додаток — нативний додаток iOS/Android; використовує PKCE з ротацією токенів оновлення.
- Машина до машини — бекенд-сервіс, що діє від свого імені (клієнтські облікові дані); без входу користувача.
Ось кроки створення додатку:
- На сторінці додатків натисніть кнопку
Create new application. - Назва Дайте вашому додатку ім’я. наприклад Cool App
- Тип клієнта Оберіть тип, що відповідає способу автентифікації вашого додатку — див. Типи клієнтів вище.
- Redirect URIs Потрібен принаймні один URI перенаправлення. Він використовується для перевірки домену перенаправлення після успішної автентифікації. Не використовується для додатків Машина до машини. наприклад 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 — Акаунт, Інвентар та тарифи, Бронювання,
Маркетинг і промоакції, Контент власності, Аналітика та звіти, Інтеграції з менеджером каналів,
Платежі та Бухгалтерія — кожна з простим описом того, що вона відкриває. Використовуйте
посилання All / None над списком, щоб вибрати або зняти всі додаткові scopes одночасно.
Дві групи scopes навмисно не пропонуються у цій формі:
mcp.*— доступ AI-агента до транспортного протоколу Model Context Protocol. Ви не створюєте для цього додаток: AI-клієнти, такі як Claude, ChatGPT або Codex, реєструються самі і запитують ці scopes при вході через екран згоди MCP. Вони ніколи не надаються додаткам Машина до машини, бо MCP завжди діє від імені увійшлого користувача.- Scopes рівня адміністратора (
administrator.*) — доступ на рівні платформи, який не надається окремо для додатків.
Після створення додатку ця вкладка та Consented Apps показують надані scopes, згруповані за секціями (наприклад, “Bookings: booking.read”), щоб ви могли швидко побачити, що може робити додаток, не відкриваючи його.
Оновлення облікових даних
Section titled “Оновлення облікових даних”Якщо секрет клієнта міг бути скомпрометований або ви просто хочете оновити облікові дані, оновіть їх замість створення нового додатку:
- Знайдіть додаток у списку та натисніть
Rotate. - Підтвердіть діалог — поточні Client ID та секрет негайно перестають працювати.
- Скопіюйте нові Client ID та секрет із одноразового діалогового вікна перед його закриттям.
Оновлення зберігає назву додатку, тип клієнта, Redirect URIs та scopes — змінюються лише облікові дані.
Видалення додатку
Section titled “Видалення додатку”Якщо додаток більше не потрібен, ви можете його видалити. Це назавжди — облікові дані відкликаються негайно і не можуть бути відновлені.
- Знайдіть додаток у списку та натисніть
Delete. - Підтвердіть діалог для остаточного видалення додатку.
