Preskočiť na obsah

Setup

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

Postupujte podľa týchto krokov:

  1. Registrovať váš používateľský účet na Wink
  2. Vytvoriť účet cestovnej kancelárie alebo partnerský účet.
  3. Vytvoriť aplikáciu kde ho prepojíte s účtom, ktorý ste vytvorili v kroku 2.
  4. Keď si vytvoríte svoj Application, uložte si ID klienta a tajný kód klienta na bezpečnom mieste.

Vo Wink používame Cloudinary pre všetky naše obrazové a video materiály. Keď získate prístup k nášmu inventáru cestovných materiálov, budete mať plný prístup ku všetkým pokročilým funkciám Cloudinary.

Našecloud_namejetraveliko.

Pre každý typ cestovného inventára, ktorý podporujeme, bude existovať vnorené pole JSON s názvommultimediasJSON pre multimediálny záznam vyzerá 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ýraznený riadok vyššie zobrazuje jedinečné ID služby Cloudinary.partners/radisson_blu_logoTo je všetko, čo potrebujete na načítanie obrázka v akomkoľvek formáte, kvalite a veľkosti, ktorú chcete.

Zamierte k našimAPIa vyberte si API, s ktorým chcete pracovať.

Naša stránka s dokumentáciou je nastavená tak, aby ste mohli spúšťať príkazy API priamo z nej.

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

:::tip[Tip od profesionála] Pre jednoduchšie použitie odporúčame integrátorom používať koncové body, ktoré označujeme akoOAuth2Tieto koncové body vedia, že majú očakávať volajúce rozhrania API a už vedia, na ktorom účte sa nachádzate, takže nemusíte špecifikovaťcompanyIdentifiervo vašich URL adresách. :::

  1. Použite Vyhľadávacie rozhranie API na vyhľadanie destinácií alebo hotelov.
  2. V ľavom navigačnom paneli kliknite na Authentication.
  3. Zadajte svoje ID klienta a tajný kľúč klienta a kliknite na Get TOKEN tlačidlo.
  4. Ak sú vaše prihlasovacie údaje platné, uvidíte, že váš kľúč API bol použitý.
  5. Teraz môžete otestovať koncový bod vyhľadávania.
Koncový bod vyhľadávacieho rozhrania API
Ukážky vyhľadávaní (OAuth2)

To isté môžete urobiť s Postmanom.

  1. Stiahnuť Poštár.
  2. Kliknite na Download OpenAPI spec z vrcholu Vyhľadávacie rozhranie API stránka.
  3. Importujte to do Postmana.
  4. Ak ste ho importovali ako novú kolekciu s názvom Wink API, kliknite na vodorovnú elipsu (3 bodky) vedľa názvu kolekcie a kliknite na Edit.
  5. V Authorization tab, nastavte Auth type do OAuth2.
  6. Nastavte pole Add auth data to k Request headers.
  7. Nastavte pole Header prefix k Bearer.
  8. Nastavte pole Token Name na akékoľvek meno uloženého tokenu v Postmane. Napr. Wink Staging.
  9. Nastavte pole Grant type k Client Credentials.
  10. Nastavte pole Access token URL na https://staging-iam.wink.travel/oauth2/token.
  11. Nastavte pole Client ID k ID klienta, ktoré vaša aplikácia pomohla vygenerovať.
  12. Nastavte pole Client Secret k tajnému kľúču klienta, ktorý vaša aplikácia pomohla vygenerovať.
  13. Nastavte pole Scope k inventory.read inventory.write inventory.removeTo sú všetky puškohľady, ktoré budete potrebovať pre Wink.
  14. Nastavte pole Client Authentication k Send as Basic Auth header.
  15. Kliknite na Get New Access Token tlačidlo na načítanie a uloženie tokenu.
  16. Pre všetky volania API v rámci kolekcie Wink API sa uistite, že na karte overenia je uvedené Inherit auth from parent takže pri každom hovore obsahuje váš token.

:::tip[Tip pre profesionálov] Odporúča sa uviesť doménu servera, ID klienta a tajný kľúč klienta do premenných prostredia. Takto môžete jednoducho prepínať medzi testovacím a produkčným prostredím a znovu použiť všetky vytvorené operácie. :::