Додатки

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

Заувага

Ваш перший додаток вже створений, коли ви створюєте новий акаунт. Ми використовуємо цей додаток для деяких сценаріїв бронювання.

Ви не можете повторно використовувати цей додаток. Будь ласка, створюйте нові додатки за потребою.

Приклад запису додатку

Заувага

Додаток, створений у Wink, можна використовувати для всіх API кінцевих точок.

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

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

Оскільки ви не маєте доступу до secret key додатку, який ми створили для вас, вам потрібно створити власний.

Обережно

Вам потрібно створити афілійований акаунт у Wink або акаунт у TripPay перед створенням додатку, оскільки ви будете прив’язувати додаток до конкретного акаунта.

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

При створенні додатку ви обираєте тип клієнта, який визначає, як додаток автентифікується:

• SPA (Single Page Application) — для фронтенд-додатків у браузері, які використовують OAuth2 authorization code flow з PKCE. Це найпоширеніший тип для веб-додатків.
• MACHINE_2_MACHINE — для інтеграцій сервер-сервер, які автентифікуються безпосередньо за допомогою клієнтських облікових даних. Використовуйте цей тип, коли ваш бекенд-сервіс має викликати Wink API без присутності користувача.

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

1. На сторінці додатків натисніть кнопку Create new application.
2. Назва Дайте вашому додатку назву. наприклад, Cool App
3. Тип клієнта Оберіть SPA для веб-додатків або MACHINE_2_MACHINE для серверних інтеграцій.
4. Назва сутності Прив’яжіть ваш додаток до одного з ваших існуючих акаунтів. наприклад, Cool Account
5. Redirect URIs Потрібен принаймні один redirect URI. Він використовується для перевірки домену перенаправлення після успішної автентифікації. наприклад, https://www.cool-site.com
6. Post-logout redirect URIs (Опційно) URL-адреси, на які користувачів можна перенаправити після виходу з системи. Це гарантує, що користувачі потраплять на відому сторінку після завершення сесії.
7. Натисніть кнопку Save, щоб продовжити.

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

Оновлення додатку

Вам потрібно оновити додаток, якщо змінюється один із redirect URI або ви хочете додати чи видалити URI.

Щоб оновити існуючий додаток, виконайте наступне:

1. Натисніть посилання Actions для додатку, який хочете оновити.
2. Натисніть кнопку Update у розділі Actions.
3. Внесіть зміни до додатку.
4. Натисніть кнопку Save, щоб продовжити.

Вас перенаправлять назад до списку додатків.

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

Обережно

Будь ласка, не видаляйте додаток, який ми створили автоматично, щоб усі функції працювали для вашого акаунта.

Якщо додаток вам більше не потрібен, ви можете його видалити.

Щоб видалити додаток, виконайте наступне:

1. Натисніть посилання Actions для додатку, який хочете видалити.
2. Натисніть кнопку Remove у розділі Actions.
3. Натисніть кнопку OK, щоб підтвердити видалення.

Вас перенаправлять назад до списку додатків.