Skip to content
Wink

Настройка

Тази статия показва как бързо да се настроите като разработчик и да започнете да тествате нашите API-та в Wink.

Следвайте тези стъпки:

  1. Регистрирайте се с вашия потребителски акаунт в Wink.
  2. Създайте афилиейт акаунт. Ще ви трябва, за да свържете вашето приложение. Вижте какво е Studio за повече контекст.
  3. Създайте приложение и го свържете с афилиейт акаунта, който създадохте в Стъпка 2. За интеграции API сървър-сървър изберете MACHINE_2_MACHINE като тип клиент.
  4. След като създадете вашето Application, копирайте и запазете client-id и secret key веднага — secret key се показва само веднъж и не може да бъде възстановен.

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 ID partners/radisson_blu_logo. Това е всичко, което ви трябва, за да извлечете изображението във всеки формат, качество и размер, който желаете.

Тестване

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

Отидете в нашия раздел APIs и изберете 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, за да включва вашия токен при всяко повикване.