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