Setup
Тази статия ви показва как бързо да се настроите като разработчик и да започнете да тествате нашите API-та на Wink.
:::бележка Тестването винаги трябва да се извършва в нашиясреда за подготовкаТам има много по-малко данни, но можете да тествате колкото искате, без да се налагате на производствената среда.
След като сте готови да стартирате онлайн, ще сертифицираме вашия акаунт и вашето приложение и ще можете да стартирате в нашата производствена среда. :::
Следвайте тези стъпки:
- Регистрация вашият потребителски акаунт в Wink
- Създайте сметка на туристически агент или един партньорски акаунт.
- Създаване на приложение където го свързвате с акаунта, който сте създали в стъпка 2.
- След като сте създали своя
Application
, запазете клиентския идентификатор и клиентската тайна на сигурно място.
В Wink използваме Cloudinary за всички наши изображения и видео ресурси. Когато получите достъп до нашия каталог за пътувания, ще имате пълен достъп до всички разширени функции на Cloudinary.
Нашиятcloud_name
еtraveliko
.
Облачен
Section titled “Облачен”Пример
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.partners/radisson_blu_logo
Това е всичко, от което се нуждаете, за да извлечете изображението във всеки формат, качество и размер, които желаете.
Тестване
Section titled “Тестване”Отправете се към нашияAPIраздел и изберете API, с който искате да работите.
API документация
Section titled “API документация”Нашият сайт за документация е настроен по такъв начин, че можете да изпълнявате API команди от самия сайт.
В този пример искате да използватеSearch Lookups (OAuth2)
API повикване.
:::tip[Професионален съвет]
За по-лесно използване препоръчваме интеграторите да използват крайните точки, които ние обозначаваме катоOAuth2
Тези крайни точки знаят да очакват API повиквания и вече знаят в кой акаунт сте, така че не е нужно да го посочвате.companyIdentifier
във вашите URL адреси.
:::
- Използвайте API за търсене за извличане на дестинации или хотели.
- В лявата навигационна лента щракнете върху
Authentication
. - Въведете вашия клиентски идентификатор и клиентска тайна и щракнете върху
Get TOKEN
бутон. - Ако вашите идентификационни данни са валидни, ще видите, че вашият API ключ е приложен.
- Вече можете да тествате крайната точка за търсене.
Пощальон
Section titled “Пощальон”Можете да направите същото и с Postman.
- Изтегляне Пощальон.
- Кликнете върху
Download OpenAPI spec
от върха на API за търсене страница. - Импортирайте го в Postman.
- Ако сте го импортирали като нова колекция, наречена
Wink API
, щракнете върху хоризонталната многоточие (3 точки) до името на колекцията и щракнетеEdit
. - В
Authorization tab
, задайтеAuth type
към OAuth2. - Задайте полето
Add auth data to
доRequest headers
. - Задайте полето
Header prefix
доBearer
. - Задайте полето
Token Name
на каквото и да е име за запазения ви токен в Postman. Например Wink Staging. - Задайте полето
Grant type
доClient Credentials
. - Задайте полето
Access token URL
към https://staging-iam.wink.travel/oauth2/token. - Задайте полето
Client ID
към клиентския идентификатор, който вашето приложение е помогнало да се генерира. - Задайте полето
Client Secret
към клиентската тайна, която вашето приложение е помогнало да се генерира. - Задайте полето
Scope
доinventory.read inventory.write inventory.remove
Това са всички мерници, които ще ви трябват за Wink. - Задайте полето
Client Authentication
доSend as Basic Auth header
. - Кликнете върху
Get New Access Token
бутон, за да извлечете вашия токен и да го запазите. - За всички API извиквания в колекцията Wink API, уверете се, че разделът за удостоверяване показва
Inherit auth from parent
така че включва вашия токен при всяко повикване.
:::tip[Професионален съвет] Препоръчително е домейнът на сървъра, клиентският идентификатор и клиентската тайна да бъдат превърнати в променливи на средата. По този начин можете лесно да превключвате между тестова и производствена среда и да използвате повторно всички създадени от вас операции. :::