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 zaloge, 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 zaloge, ki ga podpiramo, bo v gnezdenem JSON polju 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 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

Section titled “Dokumentacija API”

Naša dokumentacija je urejena tako, da lahko API ukaze izvajate neposredno znotraj strani.

V tem primeru želite uporabiti klic API 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 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 presledkom ločene obsege, ki jih vaša integracija potrebuje (npr. inventory.read inventory.write inventory.remove). Za celoten seznam glejte referenco obsegov.
  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 pod zbirko Wink API poskrbite, da zavihek za avtentikacijo pravi Inherit auth from parent, da se vaš žeton vključi pri vsakem klicu.