Setup
Ta članek vam pokaže, kako se hitro usposobiti kot razvijalec in začeti testirati naše API-je na Winku.
Sledite tem korakom:
- Registracija vaš uporabniški račun na Winku
- Ustvari račun potovalnega agenta ali partnerski račun.
- Ustvari aplikacijo kjer ga povežete z računom, ki ste ga ustvarili v 2. koraku.
- Ko ustvarite svoj
Application
, shranite ID odjemalca in skrivnost odjemalca na varno mesto.
Pri Winku za vse naše slikovne in video materiale uporabljamo Cloudinary. Ko dostopate do naše potovalne ponudbe, boste imeli poln dostop do vseh naprednih funkcij Cloudinaryja.
Našecloud_name
jetraveliko
.
Oblačno
Section titled “Oblačno”Primer
Section titled “Primer”Za vsako vrsto potovalne opreme, ki jo podpiramo, bo na voljo vgnezdeno polje JSON z imenommultimedias
JSON za večpredstavnostni vnos izgleda takole:
{ "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" } ]}
Označena črta zgoraj prikazuje edinstveni ID Cloudinaryja.partners/radisson_blu_logo
To je vse, kar potrebujete za pridobitev slike v poljubni obliki, kakovosti in velikosti, ki jo želite.
Testiranje
Section titled “Testiranje”Pojdite k našemuAPI-jiin izberite API, s katerim želite delati.
Dokumentacija API-ja
Section titled “Dokumentacija API-ja”Naše spletno mesto z dokumentacijo je nastavljeno tako, da lahko ukaze API izvajate kar znotraj spletnega mesta.
V tem primeru želite uporabitiSearch Lookups (OAuth2)
Klic API-ja.
:::nasvet[Nasvet profesionalca]
Za lažjo uporabo priporočamo, da integratorji uporabljajo končne točke, ki jih označimo kotOAuth2
Te končne točke vedo, da morajo pričakovati klicatelje API-ja in že vedo, v katerem računu ste, zato vam ni treba določiti …companyIdentifier
v vaših URL-jih.
:::
- Uporabite Iskalni API za pridobitev destinacij ali hotelov.
- V levi navigacijski vrstici kliknite na
Authentication
. - Vnesite svoj ID odjemalca in skrivno kodo odjemalca ter kliknite
Get TOKEN
gumb. - Če so vaše poverilnice veljavne, boste videli, da je bil vaš ključ API uporabljen.
- Zdaj lahko preizkusite končno točko iskanja.
Poštar
Section titled “Poštar”Enako lahko storite s Postmanom.
- Prenesi Poštar.
- Kliknite na
Download OpenAPI spec
z vrha Iskalni API stran. - Uvozi ga v Postman.
- Če ste ga uvozili kot novo zbirko z imenom
Wink API
, kliknite na vodoravno elipso (3 pike) poleg imena zbirke in klikniteEdit
. - V
Authorization tab
, nastaviteAuth type
v OAuth2. - Nastavi polje
Add auth data to
doRequest headers
. - Nastavi polje
Header prefix
doBearer
. - Nastavi polje
Token Name
poljubno ime shranjenega žetona v Postmanu. Npr. Wink Staging. - Nastavi polje
Grant type
doClient Credentials
. - Nastavi polje
Access token URL
na https://staging-iam.wink.travel/oauth2/token. - Nastavi polje
Client ID
na ID stranke, ki ga je vaša aplikacija pomagala ustvariti. - Nastavi polje
Client Secret
do skrivnosti odjemalca, ki jo je vaša aplikacija pomagala ustvariti. - Nastavi polje
Scope
doinventory.read inventory.write inventory.remove
To so vsi daljnogledi, ki jih boste potrebovali za Wink. - Nastavi polje
Client Authentication
doSend as Basic Auth header
. - Kliknite na
Get New Access Token
gumb za pridobitev žetona in njegovo shranjevanje. - Za vse klice API-ja v zbirki Wink API se prepričajte, da je na zavihku za preverjanje pristnosti navedeno
Inherit auth from parent
zato pri vsakem klicu vključi vaš žeton.
:::nasvet[Nasvet profesionalca] Priporočljivo je, da domeno strežnika, ID odjemalca in skrivno vrednost odjemalca spremenite v okoljske spremenljivke. Tako lahko preprosto preklapljate med preizkusnim in produkcijskim okoljem ter ponovno uporabite vse ustvarjene operacije. :::