Přeskočit na obsah
Academy

Nastavení

Tento článek vám ukáže, jak se rychle nastavit jako vývojář a začít testovat naše API na Wink.

Postupujte podle těchto kroků:

  1. Zaregistrujte si uživatelský účet na Wink
  2. Vytvořte si účet cestovní kanceláře nebo affiliate účet.
  3. Vytvořte aplikaci, kterou spojíte s účtem vytvořeným v kroku 2.
  4. Jakmile vytvoříte Application, uložte si client-id a client secret na bezpečné místo.

CDN

Section titled “CDN”

Ve Wink používáme Cloudinary pro všechny naše obrazové a video zdroje. Když přistupujete k naší cestovní nabídce, budete mít plný přístup ke všem pokročilým funkcím Cloudinary.

Naše cloud_name je traveliko.

Cloudinary

Section titled “Cloudinary”

Příklad

Section titled “Příklad”

Pro každý typ cestovní nabídky, který podporujeme, bude existovat vnořený JSON pole nazvané multimedias. JSON pro položku multimedia vypadá takto:

{
  "multimediaIdentifier": "multimedia-1",
  "identifier": "partners/radisson_blu_logo",
  "type": "IMAGE",
  "width": "1024",
  "height": "768",
  "category": "1",
  "descriptions": [
    {
      "name": "Lobby",
      "description": "Obrázek lobby",
      "language": "en"
    }
  ],
  "lifestyleType": "LIFESTYLE_BUSINESS",
  "attribution": [
    {
      "url": "https://www.hilton.com",
      "name": "Hilton"
    }
  ]
}

Zvýrazněný řádek výše ukazuje unikátní ID Cloudinary partners/radisson_blu_logo. To je vše, co potřebujete k získání obrázku v jakémkoli formátu, kvalitě a velikosti.

Testování

Section titled “Testování”

Přejděte do naší sekce API a 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 API příkazy přímo ze stránky.

V tomto příkladu chcete použít volání API Search Lookups (OAuth2).

  1. Použijte Lookup API k získání destinací nebo hotelů.
  2. V levém navigačním panelu klikněte na Authentication.
  3. Zadejte svůj client-id a client secret a klikněte na tlačítko Get TOKEN.
  4. Pokud jsou vaše přihlašovací údaje platné, uvidíte, že váš API klíč byl aplikován.
  5. Nyní můžete testovat lookup endpoint.
Lookup API endpoint
Ukázka Search Lookups (OAuth2)

Postman

Section titled “Postman”

Totéž můžete udělat i v Postmanu.

  1. Stáhněte si Postman.
  2. Klikněte na Download OpenAPI spec v horní části stránky Lookup API.
  3. Importujte to do Postmanu.
  4. Pokud jste to importovali jako novou kolekci s názvem Wink API, klikněte na horizontální elipsu (3 tečky) vedle názvu kolekce a zvolte Edit.
  5. V záložce Authorization nastavte Auth type na 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, pod kterým chcete token v Postmanu uložit, 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 na Client ID, které vám aplikace pomohla vygenerovat.
  12. Nastavte pole Client Secret na Client Secret, které vám aplikace pomohla vygenerovat.
  13. Nastavte pole Scope na inventory.read inventory.write inventory.remove. To jsou všechny scope, které pro Wink potřebujete.
  14. Nastavte pole Client Authentication na Send as Basic Auth header.
  15. Klikněte na tlačítko Get New Access Token pro získání tokenu a jeho uložení.
  16. U všech API volání v kolekci Wink API se ujistěte, že záložka autorizace říká Inherit auth from parent, aby se token přidal ke každému volání.