Skip to content
Wink

Nastavitev

Ta članek vam pokaže, kako se hitro nastaviti kot razvijalec in začeti testirati naše API-je na Wink.

Sledite tem korakom:

  1. Registrirajte svoj uporabniški račun na Wink.
  2. Ustvarite partnerski račun. Ta je potreben za povezavo vaše aplikacije. Za več informacij glejte kaj je Studio.
  3. Ustvarite aplikacijo in jo povežite s partnerskim računom, ki ste ga ustvarili v koraku 2. Za API integracije strežnik-strežnik izberite MACHINE_2_MACHINE kot tip odjemalca.
  4. Ko ustvarite svojo Application, takoj kopirajte in shranite client-id in skrivni ključ — skrivni ključ je prikazan samo enkrat in ga ni mogoče več pridobiti.

CDN

Section titled “CDN”

Pri Wink uporabljamo Cloudinary za vse naše slikovne in video vsebine. Ko dostopate do naše potovalne ponudbe, imate popoln dostop do vseh naprednih funkcij Cloudinary.

Naš cloud_name je traveliko.

Cloudinary

Section titled “Cloudinary”

Primer

Section titled “Primer”

Za vsak tip potovalne ponudbe, ki ga podpiramo, obstaja gnezden JSON niz z imenom multimedias. JSON za vnos multimedije izgleda takole:

{
  "multimediaIdentifier": "multimedia-1",
  "identifier": "partners/radisson_blu_logo",
  "type": "IMAGE",
  "width": "1024",
  "height": "768",
  "category": "1",
  "descriptions": [
    {
      "name": "Lobby",
      "description": "Slika avle",
      "language": "en"
    }
  ],
  "lifestyleType": "LIFESTYLE_BUSINESS",
  "attribution": [
    {
      "url": "https://www.hilton.com",
      "name": "Hilton"
    }
  ]
}

Označena vrstica zgoraj prikazuje edinstveni ID Cloudinary partners/radisson_blu_logo. To je vse, kar potrebujete za pridobitev slike v katerikoli obliki, kakovosti in velikosti.

Testiranje

Section titled “Testiranje”

Pojdite v našo sekcijo API-ji in izberite API, s katerim želite delati.

Dokumentacija API-jev

Section titled “Dokumentacija API-jev”

Naša dokumentacijska stran je nastavljena tako, da lahko API ukaze izvajate neposredno znotraj strani.

V tem primeru želite uporabiti klic API-ja Search Lookups (OAuth2).

  1. Uporabite Lookup API za pridobivanje destinacij ali hotelov.
  2. V levem meniju kliknite na Authentication.
  3. Vnesite svoj client-id in skrivni ključ ter kliknite gumb Get TOKEN.
  4. Če so vaše poverilnice veljavne, boste videli, da je vaš API ključ uporabljen.
  5. Zdaj lahko testirate lookup končno točko.
Lookup API endpoint
Primer Search Lookups (OAuth2)

Postman

Section titled “Postman”

Enako lahko naredite tudi s Postmanom.

  1. Prenesite Postman.
  2. Kliknite na Download OpenAPI spec na vrhu strani Lookup API.
  3. Uvozite ga v Postman.
  4. Če ste ga uvozili kot novo zbirko z imenom Wink API, kliknite na horizontalne tri pike poleg imena zbirke in izberite Edit.
  5. V zavihku Authorization nastavite Auth type na OAuth2.
  6. Nastavite polje Add auth data to na Request headers.
  7. Nastavite polje Header prefix na Bearer.
  8. Nastavite polje Token Name na poljubno ime za vaš shranjeni žeton v Postmanu, npr. Wink Staging.
  9. Nastavite polje Grant type na Client Credentials.
  10. Nastavite polje Access token URL na https://staging-iam.wink.travel/oauth2/token.
  11. Nastavite polje Client ID na Client ID, ki ga je vaša aplikacija ustvarila.
  12. Nastavite polje Client Secret na skrivni ključ, ki ga je vaša aplikacija ustvarila.
  13. Nastavite polje Scope na inventory.read inventory.write inventory.remove. To so vsi obsegi, ki jih boste potrebovali za Wink.
  14. Nastavite polje Client Authentication na Send as Basic Auth header.
  15. Kliknite gumb Get New Access Token, da pridobite in shranite svoj žeton.
  16. Za vse klice API-jev v zbirki Wink API poskrbite, da zavihek za avtentikacijo pravi Inherit auth from parent, da se vaš žeton vključi pri vsakem klicu.