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

Настройка

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

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

  1. Зарегистрируйте свой пользовательский аккаунт на Wink.
  2. Создайте аккаунт партнёра. Он понадобится для привязки вашего приложения. Подробнее смотрите в разделе что такое Studio.
  3. Создайте приложение и свяжите его с аккаунтом партнёра, созданным на шаге 2. Для интеграций API сервер-сервер выберите тип клиента MACHINE_2_MACHINE.
  4. После создания Application сразу скопируйте и сохраните client-id и секретный ключ — секретный ключ показывается только один раз и не может быть восстановлен.

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.
Lookup API endpoint
Пример 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). Полный список смотрите в справочнике по scope.
  14. В поле Client Authentication выберите Send as Basic Auth header.
  15. Нажмите кнопку Get New Access Token, чтобы получить токен и сохранить его.
  16. Для всех вызовов API в коллекции Wink API убедитесь, что во вкладке аутентификации стоит Inherit auth from parent, чтобы токен автоматически добавлялся к каждому запросу.