Postavljanje
Ovaj članak pokazuje kako se brzo postaviti kao programer i početi testirati naše API-je na Wink-u.
Slijedite ove korake:
- Registrirajte se kao korisnik na Wink-u
- Kreirajte račun turističkog agenta ili affiliate račun.
- Kreirajte aplikaciju i povežite je s računom koji ste kreirali u Koraku 2.
- Nakon što ste kreirali svoju
Application, spremite client-id i client secret na sigurno mjesto.
Na Wink-u koristimo Cloudinary za sve naše slike i video zapise. Kada pristupite našem inventaru putovanja, imat ćete potpuni pristup svim naprednim značajkama Cloudinary-a.
Naš cloud_name je traveliko.
Cloudinary
Section titled “Cloudinary”Primjer
Section titled “Primjer”Za svaki tip inventara putovanja koji podržavamo, postoji ugniježđeni JSON niz nazvan multimedias. JSON za jedan multimedijski unos izgleda ovako:
{ "multimediaIdentifier": "multimedia-1", "identifier": "partners/radisson_blu_logo", "type": "IMAGE", "width": "1024", "height": "768", "category": "1", "descriptions": [ { "name": "Lobby", "description": "Slika lobija", "language": "en" } ], "lifestyleType": "LIFESTYLE_BUSINESS", "attribution": [ { "url": "https://www.hilton.com", "name": "Hilton" } ]}Istaknuti redak iznad prikazuje jedinstveni Cloudinary ID partners/radisson_blu_logo. To je sve što vam treba za dohvat slike u bilo kojem formatu, kvaliteti i veličini koju želite.
Testiranje
Section titled “Testiranje”Idite na našu sekciju API-je i odaberite API s kojim želite raditi.
API dokumentacija
Section titled “API dokumentacija”Naša stranica s dokumentacijom postavljena je tako da možete izvoditi API naredbe izravno sa stranice.
U ovom primjeru želite koristiti API poziv Search Lookups (OAuth2).
- Koristite Lookup API za dohvat destinacija ili hotela.
- U lijevom izborniku kliknite na
Authentication. - Unesite svoj client-id i client secret te kliknite na gumb
Get TOKEN. - Ako su vaše vjerodajnice valjane, vidjet ćete da je vaš API ključ primijenjen.
- Sada možete testirati lookup endpoint.
Postman
Section titled “Postman”Isto možete napraviti i s Postman-om.
- Preuzmite Postman.
- Kliknite na
Download OpenAPI specna vrhu stranice Lookup API. - Uvezite ga u Postman.
- Ako ste ga uvezli kao novu kolekciju pod nazivom
Wink API, kliknite na horizontalne tri točke pored imena kolekcije i odaberiteEdit. - U kartici
AuthorizationpostaviteAuth typena OAuth2. - Postavite polje
Add auth data tonaRequest headers. - Postavite polje
Header prefixnaBearer. - Postavite polje
Token Namena ime koje želite dati svom spremljenom tokenu u Postmanu, npr. Wink Staging. - Postavite polje
Grant typenaClient Credentials. - Postavite polje
Access token URLna https://staging-iam.wink.travel/oauth2/token. - Postavite polje
Client IDna Client ID koji je vaša aplikacija generirala. - Postavite polje
Client Secretna Client Secret koji je vaša aplikacija generirala. - Postavite polje
Scopenainventory.read inventory.write inventory.remove. To su svi opsezi koji su vam potrebni za Wink. - Postavite polje
Client AuthenticationnaSend as Basic Auth header. - Kliknite gumb
Get New Access Tokenda dohvatite i spremite svoj token. - Za sve API pozive unutar Wink API kolekcije, provjerite da kartica za autentifikaciju kaže
Inherit auth from parentkako bi se vaš token uključivao u svaki poziv.