Přeskočit na obsah

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:

  1. Rejstřík váš uživatelský účet na Winku
  2. Vytvořte účet cestovní kanceláře nebo partnerský účet.
  3. Vytvořte aplikaci kde jej propojíte s účtem, který jste vytvořili v kroku 2.
  4. 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_namejetraveliko.

Pro každý typ cestovního inventáře, který podporujeme, bude existovat vnořené pole JSON s názvemmultimediasJSON 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_logoTo je vše, co potřebujete k načtení obrázku v libovolném formátu, kvalitě a velikosti, kterou chcete.

Zamiřte k našimAPIa vyberte API, se kterým chcete pracovat.

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 jakoOAuth2Tyto 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…companyIdentifierve vašich URL adresách. :::

  1. Použijte Vyhledávací API pro vyhledání destinací nebo hotelů.
  2. V levém navigačním panelu klikněte na Authentication.
  3. Zadejte své ID klienta a tajný klíč klienta a klikněte na Get TOKEN tlačítko.
  4. Pokud jsou vaše přihlašovací údaje platné, uvidíte, že váš klíč API byl použit.
  5. Nyní můžete otestovat koncový bod vyhledávání.
Koncový bod vyhledávacího API
Ukázkové vyhledávací dotazy (OAuth2)

Totéž můžete udělat s Postmanem.

  1. Stáhnout Listonoš.
  2. Klikněte na Download OpenAPI spec z vrcholu Vyhledávací API strana.
  3. Importujte to do Postmana.
  4. 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 na Edit.
  5. V Authorization tab, nastavte Auth type k OAuth2.
  6. Nastavte pole Add auth data to na Request headers.
  7. Nastavte pole Header prefix na Bearer.
  8. Nastavte pole Token Name na libovolný název uloženého tokenu v Postmanu. Např. Wink Staging.
  9. Nastavte pole Grant type na Client Credentials.
  10. Nastavte pole Access token URL na https://staging-iam.wink.travel/oauth2/token.
  11. Nastavte pole Client ID k ID klienta, které vaše aplikace pomohla vygenerovat.
  12. Nastavte pole Client Secret k tajnému klíči klienta, který vaše aplikace pomohla vygenerovat.
  13. Nastavte pole Scope na inventory.read inventory.write inventory.removeTo jsou všechny puškohledy, které budete pro Wink potřebovat.
  14. Nastavte pole Client Authentication na Send as Basic Auth header.
  15. Klikněte na Get New Access Token tlačítko pro načtení a uložení tokenu.
  16. 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. :::