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