Preskočiť na obsah
Wink

Nastavenie

Tento článok vám ukáže, ako sa rýchlo nastaviť ako vývojár a začať testovať naše API na Wink.

Postupujte podľa týchto krokov:

  1. Zaregistrujte sa ako používateľ na Wink.
  2. Vytvorte si partnerský účet. Tento účet budete potrebovať na prepojenie vašej aplikácie. Viac informácií nájdete v čo je Studio.
  3. Vytvorte aplikáciu a priraďte ju k partnerskému účtu, ktorý ste vytvorili v kroku 2. Pre serverové API integrácie vyberte ako typ klienta MACHINE_2_MACHINE.
  4. Po vytvorení Application si okamžite skopírujte a uložte client-id a tajný kľúč — tajný kľúč sa zobrazí iba raz a nie je možné ho získať znova.

CDN

Section titled “CDN”

Vo Wink používame Cloudinary pre všetky naše obrazové a video súbory. Keď pristupujete k nášmu cestovnému inventáru, máte plný prístup ku všetkým pokročilým funkciám Cloudinary.

Naše cloud_name je traveliko.

Cloudinary

Section titled “Cloudinary”

Príklad

Section titled “Príklad”

Pre každý typ cestovného inventára, ktorý podporujeme, existuje vnorené JSON pole nazvané multimedias. JSON pre multimediálnu položku vyzerá takto:

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

Zvýraznený riadok ukazuje unikátne ID Cloudinary partners/radisson_blu_logo. To je všetko, čo potrebujete na získanie obrázka v ľubovoľnom formáte, kvalite a veľkosti.

Testovanie

Section titled “Testovanie”

Prejdite do sekcie našich API a vyberte API, s ktorým chcete pracovať.

Dokumentácia API

Section titled “Dokumentácia API”

Naša dokumentácia je nastavená tak, že môžete spúšťať API príkazy priamo zo stránky.

V tomto príklade chcete použiť API volanie Search Lookups (OAuth2).

  1. Použite Lookup API na získanie destinácií alebo hotelov.
  2. V ľavom navigačnom paneli kliknite na Authentication.
  3. Zadajte svoj client-id a client secret a kliknite na tlačidlo Get TOKEN.
  4. Ak sú vaše údaje platné, uvidíte, že váš API kľúč bol aplikovaný.
  5. Teraz môžete testovať lookup endpoint.
Lookup API endpoint
Ukážka Search Lookups (OAuth2)

Postman

Section titled “Postman”

To isté môžete urobiť aj pomocou Postman.

  1. Stiahnite si Postman.
  2. Kliknite na Download OpenAPI spec v hornej časti stránky Lookup API.
  3. Importujte ho do Postman.
  4. Ak ste ho importovali ako novú kolekciu s názvom Wink API, kliknite na horizontálne tri bodky vedľa názvu kolekcie a vyberte Edit.
  5. V záložke 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 ľubovoľný názov, pod ktorým chcete token uložiť v Postman. Napr. 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, ktoré vám aplikácia vygenerovala.
  12. Nastavte pole Client Secret na Client Secret, ktoré vám aplikácia vygenerovala.
  13. Nastavte pole Scope na inventory.read inventory.write inventory.remove. Toto sú všetky scope, ktoré budete pre Wink potrebovať.
  14. Nastavte pole Client Authentication na Send as Basic Auth header.
  15. Kliknite na tlačidlo Get New Access Token pre získanie tokenu a jeho uloženie.
  16. Pre všetky API volania v kolekcii Wink API sa uistite, že záložka autentifikácie hovorí Inherit auth from parent, aby sa token pridal ku každému volaniu.