Перейти до вмісту
Academy

Налаштування

Ця стаття показує, як швидко налаштуватися як розробник і почати тестувати наші API на Wink.

Виконайте ці кроки:

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

CDN

Section titled “CDN”

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

Наш cloud_name — traveliko.

Cloudinary

Section titled “Cloudinary”

Приклад

Section titled “Приклад”

Для кожного типу туристичного інвентарю, який ми підтримуємо, існує вкладений масив 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. Це все, що вам потрібно, щоб отримати зображення у будь-якому форматі, якості та розмірі.

Тестування

Section titled “Тестування”

Перейдіть до нашого розділу API і виберіть API, з яким хочете працювати.

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

Section titled “Документація API”

Наш сайт документації налаштований так, що ви можете виконувати API-запити безпосередньо на сайті.

У цьому прикладі ви хочете використати виклик API Search Lookups (OAuth2).

  1. Використайте Lookup API для отримання інформації про напрямки або готелі.
  2. У лівому меню натисніть на Authentication.
  3. Введіть свій client-id та client secret і натисніть кнопку Get TOKEN.
  4. Якщо ваші облікові дані дійсні, ви побачите, що ваш API ключ застосовано.
  5. Тепер ви можете тестувати кінцеву точку lookup.
Кінцева точка Lookup API
Приклад Search Lookups (OAuth2)

Postman

Section titled “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, щоб токен додавався до кожного виклику.