Setup

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

Заметка

Тестирование всегда должно происходить в нашемсреда подготовки. Там гораздо меньше данных, но вы можете тестировать столько, сколько захотите, не нагружая производственную среду.

Как только вы будете готовы к запуску, мы сертифицируем вашу учетную запись и ваше приложение, и вы сможете запустить его в нашей производственной среде.

Выполните следующие действия:

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

CDN

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

Наш cloud_name является traveliko.

Облачно

• Начиная
• SDK
• Cloudinary на GitHub
• Видеоуроки

Пример

Для каждого поддерживаемого нами типа туристического инвентаря будет существовать вложенный массив 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"
    }
  ]
}

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

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

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

API-документы

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

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

:::tip[Совет профессионала] Для простоты использования мы рекомендуем интеграторам использовать конечные точки, которые мы обозначаем какOAuth2. Эти конечные точки знают, что нужно ожидать вызовов API, и уже знают, в какой учетной записи вы находитесь, поэтому вам не нужно указыватьcompanyIdentifierв ваших URL-адресах. :::

1. Используйте API поиска для поиска пунктов назначения или отелей.
2. В левой навигационной панели нажмите на Authentication.
3. Введите свой идентификатор клиента и секретный код клиента и нажмите кнопку Get TOKEN кнопка.
4. Если ваши учетные данные действительны, вы увидите, что ваш ключ API был применен.
5. Теперь вы можете протестировать конечную точку поиска.

Примеры поисковых запросов (OAuth2)

Почтальон

То же самое можно сделать и с Postman.

1. Скачать Почтальон.
2. Нажмите на Download OpenAPI spec с вершины API поиска страница.
3. Импортируйте его в Postman.
4. Если вы импортировали его как новую коллекцию под названием Wink API, нажмите на горизонтальное многоточие (3 точки) рядом с названием коллекции и нажмите Edit.
5. В Authorization tab, установите 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 к идентификатору клиента, который помогло сгенерировать ваше приложение.
12. Установить поле 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 поэтому он включает ваш токен в каждый вызов.

:::tip[Совет профессионала] Рекомендуется сделать домен сервера, идентификатор клиента и секрет клиента переменными среды. Таким образом, вы сможете легко переключаться между промежуточной и производственной средой и повторно использовать все созданные вами операции. :::