Setup

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

:::примітка Тестування завжди має відбуватися в нашомусередовище для проведення заходуТам набагато менше даних, але ви можете тестувати скільки завгодно, не нав’язуючи це виробничому середовищу.

Щойно ви будете готові до запуску, ми сертифікуємо ваш обліковий запис і вашу програму, і ви зможете запустити її в нашому робочому середовищі. :::

Виконайте такі дії:

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

CDN

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

Нашcloud_nameєtraveliko.

Хмарний

• Початок роботи
• SDK
• Cloudinary на GitHub
• Відеоуроки

Приклад

Для кожного типу туристичного інвентарю, який ми підтримуємо, буде вкладений JSON-масив під назвоюmultimediasJSON для мультимедійного запису виглядає так:

{
  "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"
    }
  ]
}

Виділений рядок вище показує унікальний ідентифікатор Cloudinarypartners/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)

Листоноша

Ви можете зробити те саме з Листоношею.

1. Завантажити Листоноша.
2. Натисніть на Download OpenAPI spec з вершини API пошуку сторінка.
3. Імпортуйте його в Postman.
4. Якщо ви імпортували його як нову колекцію під назвою Wink API, натисніть на три крапки (три горизонтальні крапки) поруч із назвою колекції та натисніть 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[Порада професіонала] Рекомендується перетворити домен сервера, ідентифікатор клієнта та секрет клієнта на змінні середовища. Таким чином, ви зможете легко перемикатися між проміжним та виробничим середовищами та повторно використовувати всі створені вами операції. :::