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

Истакнута линија изнад приказује јединствени Cloudinary IDpartners/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. Увезите га у Постман.
4. Ако сте га увезли као нову колекцију под називом Wink API, кликните на хоризонталну елипсу (3 тачке) поред имена колекције и кликните Edit.
5. У Authorization tab, подесите Auth type на OAuth2.
6. Поставите поље Add auth data to до Request headers.
7. Постави поље Header prefix до Bearer.
8. Постави поље Token Name како год желите да назовете свој сачувани токен у Постману. Нпр. 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То су сви оптички нишани који ће вам бити потребни за Винк.
14. Постави поље Client Authentication до Send as Basic Auth header.
15. Кликните на Get New Access Token дугме да бисте преузели свој токен и сачували га.
16. За све API позиве у оквиру Wink API колекције, уверите се да картица за аутентификацију каже Inherit auth from parent тако да укључује ваш токен уз сваки позив.

:::tip[Професионални савет] Препоручује се да домен сервера, ИД клијента и тајни идентификатор клијента претворите у променљиве окружења. На тај начин можете лако прелазити између припремног и производног окружења и поново користити све операције које сте креирали. :::