Перейти к содержимому

Приложения

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

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

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

При создании приложения вы выбираете тип клиента, который определяет способ аутентификации приложения. Это нельзя изменить позже — если нужен другой тип, создайте новое приложение.

  • Веб-приложение — серверное приложение, которое может безопасно хранить секрет клиента (authorization code flow).
  • Одностраничное приложение (SPA) — браузерное приложение без бэкенда; использует PKCE, без секрета клиента.
  • Мобильное приложение — нативное приложение iOS/Android; использует PKCE с ротацией refresh-токенов.
  • Машина-машине — бэкенд-сервис, действующий от своего имени (client credentials); без входа пользователя.

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

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

Вы будете перенаправлены обратно к списку приложений, и одноразовое окно покажет новый Client ID и Client secret. Скопируйте секрет сейчас и сохраните в надежном месте — он больше не будет показан, и его нельзя будет получить позже (только поменять на новый).

Каждое приложение всегда содержит 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. Они никогда не выдаются приложениям машина-машине, так как MCP всегда действует от имени вошедшего пользователя.
  • Scopes уровня администратора (administrator.*) — доступ на уровне платформы, который не предоставляется по приложению.

После создания приложения эта вкладка и Consented Apps показывают его выданные scopes, сгруппированные по разделам (например, “Bookings: booking.read”), чтобы вы могли сразу видеть, что может делать приложение, не открывая его.

Если секрет клиента мог быть скомпрометирован или вы просто хотите обновить учетные данные, поменяйте их вместо создания нового приложения:

  1. Найдите приложение в списке и нажмите Rotate.
  2. Подтвердите диалог — текущие Client ID и секрет перестают работать сразу.
  3. Скопируйте новые Client ID и секрет из одноразового окна до его закрытия.

При смене сохраняются имя приложения, тип клиента, redirect URIs и scopes — меняются только учетные данные.

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

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