Перейти до вмісту
Wink

Додатки

Додатки надають вам доступ до всіх функцій Wink як розробнику. Ви можете отримувати доступ до тих самих даних і навіть розширювати власні функції Wink. Ви можете обрати використання OAuth2 сервера Wink для автентифікації вашого туристичного сайту так само, як ви використовуєте Google або Facebook. Таким чином ви можете розширити функції Wink у вашому власному вебсайті або додатку.

Приклад додатку
Приклад запису додатку
  1. Виберіть акаунт, з яким хочете працювати, на сторінці Accounts.
  2. Натисніть Actions у нижній частині картки акаунта та оберіть Manage account.
  3. Натисніть вкладку Applications на наступній сторінці.
  4. У цьому розділі буде перелік усіх ваших додатків.
  5. Оновіть або видаліть існуючий додаток, або створіть новий.

Створення додатку

Section titled “Створення додатку”

Оскільки ви не маєте доступу до секретного ключа додатку, який ми створили для вас, вам потрібно створити власний. Ви можете створити додаток тут без попереднього налаштування власності або компанії — він не прив’язаний до жодного конкретного акаунта.

Типи клієнтів

Section titled “Типи клієнтів”

При створенні додатку ви обираєте тип клієнта, який визначає, як додаток автентифікується. Це не можна змінити пізніше — якщо потрібен інший тип, створіть новий додаток.

  • Веб-додаток — Серверний додаток, який може безпечно зберігати секрет клієнта (потік коду авторизації).
  • Односторінковий додаток (SPA) — Додаток у браузері без бекенду; використовує PKCE, без секрету клієнта.
  • Мобільний додаток — Нативний додаток iOS/Android; використовує PKCE з ротацією токенів оновлення.
  • Машина до машини — Бекенд-сервіс, що діє від свого імені (клієнтські облікові дані); без входу користувача.

Ось кроки для створення додатку:

  1. На сторінці додатків натисніть кнопку Create new application.
  2. Назва Дайте вашому додатку ім’я. наприклад Cool App
  3. Тип клієнта Оберіть тип, що відповідає способу автентифікації вашого додатку — див. Типи клієнтів вище.
  4. Redirect URIs Потрібен принаймні один URI перенаправлення. Він використовується для перевірки домену перенаправлення після успішної автентифікації. Не використовується для додатків Машина до машини. наприклад https://www.cool-site.com
  5. Post-logout redirect URIs (Опційно) URL-адреси, куди користувачів можна перенаправити після виходу з системи. Залиште порожнім, щоб повторно використовувати Redirect URIs вище.
  6. Scopes Оберіть, до чого цей додаток може мати доступ від вашого імені — див. Вибір scopes нижче.
  7. Натисніть кнопку 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, який надається окремо і лише для клієнтів Машина до машини.
  • Scopes рівня адміністратора (administrator.*) — доступ на рівні платформи, який не надається для окремих додатків.

Після створення додатку ця вкладка та Додатки з дозволами показують надані scopes, згруповані за секціями (наприклад, “Бронювання: booking.read”), щоб ви могли одразу бачити, що може робити додаток, не відкриваючи його.

Поновлення облікових даних

Section titled “Поновлення облікових даних”

Якщо секрет клієнта міг бути скомпрометований або ви просто хочете оновити облікові дані, поновіть їх замість створення нового додатку:

  1. Знайдіть додаток у списку та натисніть Rotate.
  2. Підтвердіть діалог — поточні Client ID та секрет негайно перестають працювати.
  3. Скопіюйте нові Client ID та секрет з одноразового діалогового вікна перед його закриттям.

Поновлення зберігає назву додатку, тип клієнта, Redirect URIs та scopes — змінюються лише облікові дані.

Видалення додатку

Section titled “Видалення додатку”

Якщо додаток більше не потрібен, ви можете його видалити. Це назавжди — облікові дані негайно відкликаються і не можуть бути відновлені.

  1. Знайдіть додаток у списку та натисніть Delete.
  2. Підтвердіть діалог для остаточного видалення додатку.