Přeskočit na obsah
Wink

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 affiliate účet. Budete ho potřebovat k navázání vaší aplikace. Více informací najdete v co je Studio.
  3. Vytvořte aplikaci a přiřaďte ji k affiliate účtu, který jste vytvořili v kroku 2. Pro server-to-server API integrace vyberte jako typ klienta MACHINE_2_MACHINE.
  4. Jakmile vytvoříte Application, ihned si zkopírujte a uložte client-id a secret key — tajný klíč je zobrazen pouze jednou a nelze ho znovu získat.

CDN

Sekce “CDN”

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

Naše cloud_name je traveliko.

Cloudinary

Sekce “Cloudinary”

Příklad

Sekce “Příklad”

Pro každý typ cestovní nabídky, který podporujeme, existuje vnořený JSON pole s názvem 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í

Sekce “Testování”

Přejděte do naší sekce API a vyberte API, se kterým chcete pracovat.

Dokumentace API

Sekce “Dokumentace API”

Naše dokumentace 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

Sekce “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 ho do Postmanu.
  4. Pokud jste ho 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 mezery oddělené rozsahy, které vaše integrace potřebuje (např. inventory.read inventory.write inventory.remove). Kompletní seznam najdete v referenci scope.
  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í.