Skip to content

Postavljanje

Ovaj članak pokazuje kako se brzo postaviti kao developer i početi testirati naše API-je na Wink.

Slijedite ove korake:

  1. Registrirajte se kao korisnik na Wink.
  2. Kreirajte affiliate račun. Trebat će vam za povezivanje vaše aplikacije. Pogledajte što je Marketing za dodatni kontekst.
  3. Kreirajte aplikaciju i povežite je s affiliate računom koji ste kreirali u koraku 2. Za server-to-server API integracije odaberite MACHINE_2_MACHINE kao tip klijenta.
  4. Nakon što ste kreirali svoju Application, odmah kopirajte i spremite client-id i secret key — secret key se prikazuje samo jednom i ne može se ponovno dohvatiti.

U Wink 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 je traveliko.

Za svaki tip inventara putovanja koji podržavamo, postoji ugniježđeni JSON niz nazvan multimedias. JSON za jedan multimedijski zapis 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.

Idite na naš odjeljak API-jevi i odaberite API s kojim želite raditi.

Naša dokumentacija je postavljena tako da možete izvoditi API naredbe izravno unutar stranice.

U ovom primjeru želite koristiti API poziv Search Lookups (OAuth2).

  1. Koristite Lookup API za dohvat destinacija ili hotela.
  2. U lijevom izborniku kliknite na Authentication.
  3. Unesite svoj client-id i client secret te kliknite na gumb Get TOKEN.
  4. Ako su vaši podaci ispravni, vidjet ćete da je vaš API ključ primijenjen.
  5. Sada možete testirati lookup endpoint.
Lookup API endpoint
Primjer Search Lookups (OAuth2)

Isto možete napraviti i s Postmanom.

  1. Preuzmite Postman.
  2. Kliknite na Download OpenAPI spec na vrhu stranice Lookup API.
  3. Uvezite ga u Postman.
  4. Ako ste ga uvezli kao novu kolekciju nazvanu Wink API, kliknite na horizontalne tri točke pored imena kolekcije i odaberite Edit.
  5. U kartici Authorization postavite Auth type na OAuth2.
  6. Postavite polje Add auth data to na Request headers.
  7. Postavite polje Header prefix na Bearer.
  8. Postavite polje Token Name na naziv koji želite za svoj spremljeni token u Postmanu, npr. Wink Staging.
  9. Postavite polje Grant type na Client Credentials.
  10. Postavite polje Access token URL na https://staging-iam.wink.travel/oauth2/token.
  11. Postavite polje Client ID na Client ID koji je vaša aplikacija generirala.
  12. Postavite polje Client Secret na Client Secret koji je vaša aplikacija generirala.
  13. Postavite polje Scope na razmake odvojene opsege koje vaša integracija treba (npr. inventory.read inventory.write inventory.remove). Pogledajte referencu opsega za puni popis.
  14. Postavite polje Client Authentication na Send as Basic Auth header.
  15. Kliknite gumb Get New Access Token da dohvatite i spremite svoj token.
  16. Za sve API pozive unutar Wink API kolekcije, provjerite da kartica za autentifikaciju kaže Inherit auth from parent kako bi se vaš token uključivao u svaki poziv.