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 svoj korisnički račun na Wink.
  2. Kreirajte affiliate račun. Trebat će vam za povezivanje vaše Aplikacije. Pogledajte što je Studio za više konteksta.
  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-u koristimo Cloudinary za sve naše slike i video materijale. Kada pristupite našem travel inventaru, imat ćete potpuni pristup svim naprednim značajkama Cloudinaryja.

Naš cloud_name je traveliko.

Za svaki tip travel inventara koji podržavamo, postoji ugniježđena JSON lista nazvana multimedias. JSON za jedan multimedijalni 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.

Uputite se u naš odjeljak API-jevi i odaberite API s kojim želite raditi.

Naša dokumentacijska stranica je postavljena tako da možete izvoditi API naredbe direktno sa stranice.

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

  1. Koristite Lookup API za dohvat destinacija ili hotela.
  2. U lijevom navigacijskom izborniku kliknite na Authentication.
  3. Unesite svoj client-id i client secret i kliknite na gumb Get TOKEN.
  4. Ako su vaše vjerodajnice valjane, 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 ime koje želite dati svom spremljenom tokenu 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 inventory.read inventory.write inventory.remove. To su svi opsezi koji su vam potrebni za Wink.
  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.