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

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

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

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

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

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