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

Настройка

В этой статье показано, как быстро настроиться в качестве разработчика и начать тестировать наши API на Wink.

Выполните следующие шаги:

  1. Зарегистрируйте свой пользовательский аккаунт на Wink
  2. Создайте аккаунт турагента или партнёрский аккаунт.
  3. Создайте приложение, связав его с аккаунтом, который вы создали на шаге 2.
  4. После создания Application сохраните client-id и client secret в надежном месте.

CDN

Заголовок раздела «CDN»

В Wink мы используем Cloudinary для всех наших изображений и видео. При доступе к нашему туристическому инвентарю вы получите полный доступ ко всем расширенным функциям Cloudinary.

Наш cloud_name — traveliko.

Cloudinary

Заголовок раздела «Cloudinary»

Пример

Заголовок раздела «Пример»

Для каждого типа туристического инвентаря, который мы поддерживаем, существует вложенный JSON-массив под названием multimedias. JSON для одного мультимедийного элемента выглядит так:

{
  "multimediaIdentifier": "multimedia-1",
  "identifier": "partners/radisson_blu_logo",
  "type": "IMAGE",
  "width": "1024",
  "height": "768",
  "category": "1",
  "descriptions": [
    {
      "name": "Lobby",
      "description": "Picture of the lobby",
      "language": "en"
    }
  ],
  "lifestyleType": "LIFESTYLE_BUSINESS",
  "attribution": [
    {
      "url": "https://www.hilton.com",
      "name": "Hilton"
    }
  ]
}

Выделенная строка выше показывает уникальный ID Cloudinary partners/radisson_blu_logo. Это всё, что нужно, чтобы получить изображение в любом формате, качестве и размере.

Тестирование

Заголовок раздела «Тестирование»

Перейдите в раздел наших API и выберите API, с которым хотите работать.

Документация API

Заголовок раздела «Документация API»

Наш сайт документации устроен так, что вы можете выполнять API-запросы прямо с сайта.

В этом примере вы хотите использовать вызов API Search Lookups (OAuth2).

  1. Используйте Lookup API для получения данных о направлениях или отелях.
  2. В левой навигационной панели нажмите на Authentication.
  3. Введите client-id и client secret и нажмите кнопку Get TOKEN.
  4. Если ваши учетные данные верны, вы увидите, что ваш API-ключ применён.
  5. Теперь вы можете тестировать endpoint lookup.
Endpoint Lookup API
Пример Search Lookups (OAuth2)

Postman

Заголовок раздела «Postman»

То же самое можно сделать с помощью Postman.

  1. Скачайте Postman.
  2. Нажмите Download OpenAPI spec в верхней части страницы Lookup API.
  3. Импортируйте его в Postman.
  4. Если вы импортировали его как новую коллекцию с названием Wink API, нажмите на горизонтальное меню (3 точки) рядом с названием коллекции и выберите Edit.
  5. На вкладке Authorization установите Auth type в OAuth2.
  6. Установите поле Add auth data to в Request headers.
  7. Установите поле Header prefix в Bearer.
  8. В поле Token Name введите любое имя для сохранённого токена в Postman, например, Wink Staging.
  9. В поле Grant type выберите Client Credentials.
  10. В поле Access token URL укажите https://staging-iam.wink.travel/oauth2/token.
  11. В поле Client ID введите Client ID, который сгенерировало ваше приложение.
  12. В поле Client Secret введите Client Secret, который сгенерировало ваше приложение.
  13. В поле Scope укажите inventory.read inventory.write inventory.remove. Это все необходимые права для Wink.
  14. В поле Client Authentication выберите Send as Basic Auth header.
  15. Нажмите кнопку Get New Access Token, чтобы получить токен и сохранить его.
  16. Для всех вызовов API в коллекции Wink API убедитесь, что вкладка аутентификации установлена на Inherit auth from parent, чтобы токен автоматически добавлялся к каждому запросу.