Перейти до вмісту
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"
    }
  ]
}

Виділений рядок вище показує унікальний ID 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 endpoint
Приклад 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, щоб токен додавався до кожного виклику.