Setup
Ovaj članak vam pokazuje kako se brzo postaviti kao programer i započeti testiranje naših API-ja na Winku.
Testiranje bi se uvijek trebalo odvijati u našemokruženje za pripremuTamo ima puno manje podataka, ali možete testirati koliko god želite bez nametanja produkcijskom okruženju.
Nakon što budete spremni za objavu, certificirat ćemo vaš račun i vašu aplikaciju te ćete moći pokrenuti naš produkcijski okoliš.
Slijedite ove korake:
- Registar vaš korisnički račun na Winku
- Stvori račun putničkog agenta ili partnerski račun.
- Izradi aplikaciju gdje ga povezujete s računom koji ste kreirali u 2. koraku.
- Nakon što ste stvorili svoj
Application
, spremite ID klijenta i tajnu klijenta na sigurno mjesto.
U Winku koristimo Cloudinary za sve naše slike i video materijale. Kada pristupite našem inventaru putovanja, imat ćete potpuni pristup svim naprednim značajkama Cloudinaryja.
Našcloud_name
jetraveliko
.
Oblačno
Section titled “Oblačno”Primjer
Section titled “Primjer”Za svaku vrstu putničkog inventara koju podržavamo postojat će ugniježđeni JSON niz pod nazivommultimedias
JSON za multimedijski unos izgleda ovako:
{ "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" } ]}
Istaknuti redak iznad prikazuje jedinstveni Cloudinary IDpartners/radisson_blu_logo
To je sve što vam je potrebno za preuzimanje slike u bilo kojem formatu, kvaliteti i veličini koju želite.
Testiranje
Section titled “Testiranje”Posjetite našeApisodjeljak i odaberite API s kojim želite raditi.
API dokumentacija
Section titled “API dokumentacija”Naša dokumentacijska stranica postavljena je na način da možete pokretati API naredbe unutar stranice.
U ovom primjeru želite koristitiSearch Lookups (OAuth2)
API poziv.
:::tip[Profesionalni savjet]
Radi lakšeg korištenja preporučujemo da integratori koriste krajnje točke koje označavamo kaoOAuth2
Te krajnje točke znaju očekivati API pozive i već znaju na kojem se računu nalazite tako da ne morate navoditicompanyIdentifier
u vašim URL-ovima.
:::
- Koristite API za pretraživanje za pronalaženje odredišta ili hotela.
- U lijevoj navigacijskoj traci kliknite na
Authentication
. - Unesite svoj klijentski ID i tajni klijent te kliknite
Get TOKEN
gumb. - Ako su vaši podaci za prijavu valjani, vidjet ćete da je vaš API ključ primijenjen.
- Sada možete testirati krajnju točku pretraživanja.
Poštar
Section titled “Poštar”Isto možete učiniti i s Postmanom.
- Preuzmi Poštar.
- Kliknite na
Download OpenAPI spec
s vrha API za pretraživanje stranica. - Uvezi ga u Postman.
- Ako ste ga uvezli kao novu kolekciju pod nazivom
Wink API
, kliknite na horizontalnu elipsu (3 točke) pored naziva kolekcije i klikniteEdit
. - U
Authorization tab
, postaviteAuth type
na OAuth2. - Postavi polje
Add auth data to
doRequest headers
. - Postavi polje
Header prefix
doBearer
. - Postavi polje
Token Name
kako god želite nazvati svoj spremljeni token u Postmanu. Npr. Wink Staging. - Postavi polje
Grant type
doClient Credentials
. - Postavi polje
Access token URL
na https://staging-iam.wink.travel/oauth2/token. - Postavi polje
Client ID
na ID klijenta koji je vaša aplikacija pomogla generirati. - Postavi polje
Client Secret
tajni klijent koji je vaša aplikacija pomogla generirati. - Postavi polje
Scope
doinventory.read inventory.write inventory.remove
To su svi ciljnici koji će vam trebati za Wink. - Postavi polje
Client Authentication
doSend as Basic Auth header
. - Kliknite na
Get New Access Token
gumb za preuzimanje tokena i spremanje. - Za sve API pozive unutar Wink API kolekcije, provjerite da kartica za autentifikaciju kaže
Inherit auth from parent
pa uključuje vaš token sa svakim pozivom.
:::tip[Profesionalni savjet] Preporučuje se da domenu poslužitelja, ID klijenta i tajnu klijenta pretvorite u varijable okruženja. Na taj način možete jednostavno prelaziti između pripremnog i produkcijskog okruženja i ponovno koristiti sve operacije koje ste kreirali. :::