Приложения

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

Выберите учётную запись, с которой хотите работать, на странице Accounts.
Нажмите Actions внизу карточки учётной записи и выберите Manage account.
На следующей странице перейдите на вкладку Applications.
В этом разделе будет список всех ваших приложений.
Выберите редактирование существующего приложения или создание нового.

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

Поскольку вы не можете получить доступ к секретному ключу приложения, созданного для вас, вам нужно создать своё собственное.

Типы клиентов

При создании приложения вы выбираете тип клиента, который определяет способ аутентификации приложения:

SPA (Single Page Application) — Для браузерных frontend-приложений, использующих OAuth2 с кодом авторизации и PKCE. Это самый распространённый тип для веб-приложений.
MACHINE_2_MACHINE — Для интеграций сервер-сервер, которые аутентифицируются напрямую с помощью клиентских учётных данных. Используйте этот тип, когда ваш backend-сервис должен вызывать API Wink без участия пользователя.

Вот шаги для создания приложения:

На странице приложений нажмите кнопку Create new application.
Name Дайте приложению имя. например, Cool App
Client type Выберите SPA для веб-приложений или MACHINE_2_MACHINE для серверных интеграций.
Entity name Свяжите приложение с одной из ваших существующих учётных записей. например, Cool Account
Redirect URIs Требуется как минимум один URI перенаправления. Он используется для проверки домена перенаправления после успешной аутентификации. например, https://www.cool-site.com
Post-logout redirect URIs (необязательно) URL-адреса, на которые пользователи могут быть перенаправлены после выхода из системы. Это гарантирует, что пользователи попадут на известную страницу после завершения сессии.
Нажмите кнопку Save для продолжения.

Вы будете перенаправлены обратно к списку приложений. В списке вы увидите своё новое приложение и получите доступ к секретному ключу приложения только один раз. Обязательно скопируйте его и сохраните в надёжном месте.

Обновление приложения

Вам нужно обновить приложение, если изменился один из URI перенаправления или вы хотите добавить или удалить URI.

Чтобы обновить существующее приложение, выполните следующие действия:

Нажмите ссылку Actions для приложения, которое хотите обновить.
Нажмите кнопку Update в разделе Actions.
Внесите изменения в приложение.
Нажмите кнопку Save для продолжения.

Вы будете перенаправлены обратно к списку приложений.

Удаление приложения

Если приложение вам больше не нужно, вы можете удалить его.

Чтобы удалить приложение, выполните следующие действия:

Нажмите ссылку Actions для приложения, которое хотите удалить.
Нажмите кнопку Remove в разделе Actions.
Нажмите кнопку OK для подтверждения удаления.

Вы будете перенаправлены обратно к списку приложений.