Skip to content
Academy

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 račun potovalne agencije ali partnerski račun.
  3. Ustvarite aplikacijo, ki jo povežete z računom, ki ste ga ustvarili v koraku 2.
  4. Ko ustvarite svojo Application, shranite client-id in client secret na varno mesto.

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, bo obstajala gnezdena JSON tabela 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, da pridobite sliko v katerem koli formatu, kakovosti in velikosti, ki jo želite.

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 izvajate API ukaze 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 client secret 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 endpoint.
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, s katerim želite shraniti ž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 Client Secret, 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 žeton in ga shranite.
  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.