Setup
Tento článek vám ukáže, jak se rychle stát vývojářem a začít testovat naše API na platformě Wink.
Postupujte takto:
- Rejstřík váš uživatelský účet na Winku
- Vytvořte účet cestovní kanceláře nebo partnerský účet.
- Vytvořte aplikaci kde jej propojíte s účtem, který jste vytvořili v kroku 2.
- Jakmile si vytvoříte svůj
Application
, uložte ID klienta a tajný klíč klienta na bezpečném místě.
Ve společnosti Wink používáme Cloudinary pro všechny naše obrazové a video materiály. Po přístupu k našemu cestovnímu inventáři budete mít plný přístup ke všem pokročilým funkcím Cloudinary.
Našecloud_name
jetraveliko
.
Oblačnost
Section titled “Oblačnost”Příklad
Section titled “Příklad”Pro každý typ cestovního inventáře, který podporujeme, bude existovat vnořené pole JSON s názvemmultimedias
JSON pro multimediální položku vypadá takto:
{ "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" } ]}
Zvýrazněný řádek výše zobrazuje jedinečné ID Cloudinary.partners/radisson_blu_logo
To je vše, co potřebujete k načtení obrázku v libovolném formátu, kvalitě a velikosti, kterou chcete.
Testování
Section titled “Testování”Zamiřte k našimAPIa vyberte API, se kterým chcete pracovat.
Dokumentace API
Section titled “Dokumentace API”Naše dokumentační stránka je nastavena tak, že můžete spouštět příkazy API přímo z webu.
V tomto příkladu chcete použítSearch Lookups (OAuth2)
Volání API.
:::tip[Tip pro profesionály]
Pro snazší použití doporučujeme integrátorům používat koncové body, které označujeme jakoOAuth2
Tyto koncové body vědí, že mají očekávat volající API a již vědí, na kterém účtu se nacházíte, takže nemusíte specifikovat…companyIdentifier
ve vašich URL adresách.
:::
- Použijte Vyhledávací API pro vyhledání destinací nebo hotelů.
- V levém navigačním panelu klikněte na
Authentication
. - Zadejte své ID klienta a tajný klíč klienta a klikněte na
Get TOKEN
tlačítko. - Pokud jsou vaše přihlašovací údaje platné, uvidíte, že váš klíč API byl použit.
- Nyní můžete otestovat koncový bod vyhledávání.
Listonoš
Section titled “Listonoš”Totéž můžete udělat s Postmanem.
- Stáhnout Listonoš.
- Klikněte na
Download OpenAPI spec
z vrcholu Vyhledávací API strana. - Importujte to do Postmana.
- Pokud jste ji importovali jako novou kolekci s názvem
Wink API
, klikněte na tři tečky (třetí tečky) vedle názvu kolekce a klikněte naEdit
. - V
Authorization tab
, nastavteAuth type
k OAuth2. - Nastavte pole
Add auth data to
naRequest headers
. - Nastavte pole
Header prefix
naBearer
. - Nastavte pole
Token Name
na libovolný název uloženého tokenu v Postmanu. Např. Wink Staging. - Nastavte pole
Grant type
naClient Credentials
. - Nastavte pole
Access token URL
na https://staging-iam.wink.travel/oauth2/token. - Nastavte pole
Client ID
k ID klienta, které vaše aplikace pomohla vygenerovat. - Nastavte pole
Client Secret
k tajnému klíči klienta, který vaše aplikace pomohla vygenerovat. - Nastavte pole
Scope
nainventory.read inventory.write inventory.remove
To jsou všechny puškohledy, které budete pro Wink potřebovat. - Nastavte pole
Client Authentication
naSend as Basic Auth header
. - Klikněte na
Get New Access Token
tlačítko pro načtení a uložení tokenu. - U všech volání API v kolekci Wink API se ujistěte, že je na kartě ověřování uvedeno
Inherit auth from parent
takže token je součástí každého hovoru.
:::tip[Tip pro profesionály] Doporučuje se uvést doménu serveru, ID klienta a tajný klíč klienta do proměnných prostředí. Tímto způsobem můžete snadno přepínat mezi testovacím a produkčním prostředím a znovu použít všechny vytvořené operace. :::