Tovább a tartalomhoz
Academy

Beállítás

Ez a cikk megmutatja, hogyan állíthatod be gyorsan fejlesztőként magad, és kezdheted el tesztelni az API-jainkat a Wink-en.

Kövesd az alábbi lépéseket:

  1. Regisztrálj egy felhasználói fiókot a Wink-en
  2. Hozz létre egy utazási ügynöki fiókot vagy egy partneri fiókot.
  3. Hozz létre egy alkalmazást, amelyet összekapcsolsz a 2. lépésben létrehozott fiókkal.
  4. Miután létrehoztad az Application-t, mentsd el biztonságos helyre a client-id-t és a client secret-et.

CDN

Szekció neve “CDN”

A Wink-nél a Cloudinary-t használjuk minden kép- és videóanyagunkhoz. Amikor hozzáférsz az utazási készletünkhöz, teljes hozzáférést kapsz a Cloudinary összes fejlett funkciójához.

A cloud_name-ünk: traveliko.

Cloudinary

Szekció neve “Cloudinary”

Példa

Szekció neve “Példa”

Minden általunk támogatott utazási készlettípushoz tartozik egy beágyazott JSON tömb multimedias néven. Egy multimédia bejegyzés JSON-je így néz ki:

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

A kiemelt sor mutatja a Cloudinary egyedi azonosítót partners/radisson_blu_logo. Ez az egyetlen, amire szükséged van, hogy bármilyen formátumban, minőségben és méretben lekérd a képet.

Tesztelés

Szekció neve “Tesztelés”

Látogass el az API-k szekciónkba, és válaszd ki a használni kívánt API-t.

API dokumentáció

Szekció neve “API dokumentáció”

A dokumentációs oldalunk úgy van kialakítva, hogy az API parancsokat közvetlenül az oldalon belül futtathatod.

Ebben a példában a Search Lookups (OAuth2) API hívást szeretnéd használni.

  1. Használd a Lookup API-t úti célok vagy szállodák lekéréséhez.
  2. A bal oldali navigációs sávban kattints az Authentication fülre.
  3. Írd be a client-id-t és a client secret-et, majd kattints a Get TOKEN gombra.
  4. Ha a hitelesítő adataid érvényesek, látni fogod, hogy az API kulcsod alkalmazva lett.
  5. Most már tesztelheted a lookup végpontot.
Lookup API végpont
Minta Search Lookups (OAuth2)

Postman

Szekció neve “Postman”

Ugyanezt megteheted Postman-nel is.

  1. Töltsd le a Postman-t.
  2. Kattints a Download OpenAPI spec gombra a Lookup API oldal tetején.
  3. Importáld be a Postman-be.
  4. Ha új gyűjteményként importáltad Wink API néven, kattints a gyűjtemény neve melletti vízszintes három pontra, majd válaszd az Edit opciót.
  5. Az Authorization fülön állítsd az Auth type-ot OAuth2-re.
  6. Állítsd be az Add auth data to mezőt Request headers-re.
  7. Állítsd be a Header prefix mezőt Bearer-re.
  8. A Token Name mezőbe írd be, hogy milyen néven szeretnéd elmenteni a tokent a Postman-ben, pl. Wink Staging.
  9. Állítsd be a Grant type mezőt Client Credentials-re.
  10. Állítsd be az Access token URL mezőt erre: https://staging-iam.wink.travel/oauth2/token.
  11. Állítsd be a Client ID mezőt az alkalmazásod által generált Client ID-re.
  12. Állítsd be a Client Secret mezőt az alkalmazásod által generált Client Secret-re.
  13. Állítsd be a Scope mezőt inventory.read inventory.write inventory.remove értékre. Ezek a Wink-hez szükséges engedélyek.
  14. Állítsd be a Client Authentication mezőt Send as Basic Auth header-re.
  15. Kattints a Get New Access Token gombra, hogy lekérd és elmentsd a tokent.
  16. Minden Wink API gyűjtemény alatti hívásnál győződj meg róla, hogy az authentication fülön az Inherit auth from parent van beállítva, így minden híváshoz hozzáadja a tokent.