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.partners/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)

Пощальон

Можете да направите същото и с Postman.

1. Изтегляне Пощальон.
2. Кликнете върху Download OpenAPI spec от върха на API за търсене страница.
3. Импортирайте го в Postman.
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 на каквото и да е име за запазения ви токен в 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[Професионален съвет] Препоръчително е домейнът на сървъра, клиентският идентификатор и клиентската тайна да бъдат превърнати в променливи на средата. По този начин можете лесно да превключвате между тестова и производствена среда и да използвате повторно всички създадени от вас операции. :::