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:
- Registrovať váš používateľský účet na Wink
- Vytvoriť účet cestovnej kancelárie alebo partnerský účet.
- Vytvoriť aplikáciu kde ho prepojíte s účtom, ktorý ste vytvorili v kroku 2.
- 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_name
jetraveliko
.
Oblačnosť
Section titled “Oblačnosť”Príklad
Section titled “Príklad”Pre každý typ cestovného inventára, ktorý podporujeme, bude existovať vnorené pole JSON s názvommultimedias
JSON 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_logo
To je všetko, čo potrebujete na načítanie obrázka v akomkoľvek formáte, kvalite a veľkosti, ktorú chcete.
Testovanie
Section titled “Testovanie”Zamierte k našimAPIa vyberte si API, s ktorým chcete pracovať.
Dokumentácia k API
Section titled “Dokumentácia k API”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 akoOAuth2
Tieto 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ťcompanyIdentifier
vo vašich URL adresách.
:::
- Použite Vyhľadávacie rozhranie API na vyhľadanie destinácií alebo hotelov.
- V ľavom navigačnom paneli kliknite na
Authentication
. - Zadajte svoje ID klienta a tajný kľúč klienta a kliknite na
Get TOKEN
tlačidlo. - Ak sú vaše prihlasovacie údaje platné, uvidíte, že váš kľúč API bol použitý.
- Teraz môžete otestovať koncový bod vyhľadávania.
Poštár
Section titled “Poštár”To isté môžete urobiť s Postmanom.
- Stiahnuť Poštár.
- Kliknite na
Download OpenAPI spec
z vrcholu Vyhľadávacie rozhranie API stránka. - Importujte to do Postmana.
- 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 naEdit
. - V
Authorization tab
, nastavteAuth type
do OAuth2. - Nastavte pole
Add auth data to
kRequest headers
. - Nastavte pole
Header prefix
kBearer
. - Nastavte pole
Token Name
na akékoľvek meno uloženého tokenu v Postmane. Napr. Wink Staging. - Nastavte pole
Grant type
kClient Credentials
. - Nastavte pole
Access token URL
na https://staging-iam.wink.travel/oauth2/token. - Nastavte pole
Client ID
k ID klienta, ktoré vaša aplikácia pomohla vygenerovať. - Nastavte pole
Client Secret
k tajnému kľúču klienta, ktorý vaša aplikácia pomohla vygenerovať. - Nastavte pole
Scope
kinventory.read inventory.write inventory.remove
To sú všetky puškohľady, ktoré budete potrebovať pre Wink. - Nastavte pole
Client Authentication
kSend as Basic Auth header
. - Kliknite na
Get New Access Token
tlačidlo na načítanie a uloženie tokenu. - 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. :::