Skip to content
Wink

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 Aplikaciju, odmah kopirajte i spremite client-id i secret key — secret key se prikazuje samo jednom i ne može se ponovno dohvatiti.

CDN

Section titled “CDN”

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 Cloudinary-a.

Naš cloud_name je traveliko.

Cloudinary

Section titled “Cloudinary”

Primjer

Section titled “Primjer”

Za svaki tip travel inventara koji podržavamo, postoji ugniježđena JSON lista pod nazivom 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.

Testiranje

Section titled “Testiranje”

Idite na našu API-je sekciju i odaberite API s kojim želite raditi.

API dokumentacija

Section titled “API dokumentacija”

Naša dokumentacija 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 izborniku kliknite na Authentication.
  3. Unesite svoj client-id i client secret te 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)

Postman

Section titled “Postman”

Isto možete napraviti i s Postman-om.

  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 pod nazivom 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 razmake odvojene opsege koje vaša integracija treba (npr. inventory.read inventory.write inventory.remove). Pogledajte referencu scope-a 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 uključila vaš token u svaki poziv.