Tovább a tartalomhoz

Setup

Ez a cikk bemutatja, hogyan lehet gyorsan fejlesztőként beállítani és elkezdeni tesztelni API-jainkat a Winken.

:::megjegyzés A tesztelésnek mindig a miénkben kell történnieszínpadi környezetSokkal kevesebb adat van ott, de annyit tesztelhetsz, amennyit csak akarsz anélkül, hogy túlterhelnéd az éles környezetet.

Amint készen állsz az éles üzembe helyezésre, hitelesítjük a fiókodat és az alkalmazásodat, és elindíthatod az éles környezetünkben. :::

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

  1. Nyilvántartás felhasználói fiókod a Wink-en
  2. Hozz létre egy utazási irodai számla vagy egy partnerfiók.
  3. Alkalmazás létrehozása ahol a 2. lépésben létrehozott fiókhoz társítja.
  4. Miután létrehoztad a Application, mentse el az ügyfél-azonosítót és az ügyfél titkos kódját biztonságos helyre.

A Winkné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 miénkcloud_namevantraveliko.

Minden általunk támogatott utazási készlettípushoz tartozik egy beágyazott JSON tömb, amelynek nevemultimediasEgy multimédiás bejegyzés JSON-ja így néz ki:

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

A fenti kiemelt sor a Cloudinary egyedi azonosítóját mutatja.partners/radisson_blu_logoEz minden, amire szükséged van a kép bármilyen formátumban, minőségben és méretben történő letöltéséhez.

Menj át a miénkhezAPI-kszakaszt, és válassza ki a használni kívánt API-t.

Dokumentációs oldalunk úgy van beállítva, hogy API parancsokat futtathasson az oldalon belül.

Ebben a példában a következőt szeretnéd használni:Search Lookups (OAuth2)API-hívás.

:::tip[Profi tipp] A könnyű használat érdekében azt javasoljuk, hogy az integrátorok az általunk kijelölt végpontokat használják.OAuth2Ezek a végpontok tudják, hogy API-hívókra kell számítaniuk, és már tudják, melyik fiókkal vagy kapcsolatban, így nem kell megadnod acompanyIdentifieraz URL-címeidben. :::

  1. Használd a Keresési API úti célok vagy szállodák lekéréséhez.
  2. A bal oldali navigációs sávon kattintson a Authentication.
  3. Adja meg az ügyfél-azonosítóját és az ügyfél titkát, majd kattintson a Get TOKEN gomb.
  4. Ha a hitelesítő adatai érvényesek, látni fogja, hogy az API-kulcsát alkalmazták.
  5. Most tesztelheti a keresési végpontot.
Keresési API végpont
Mintakeresések (OAuth2)

Ugyanezt megteheted a Postman-nel is.

  1. Letöltés Postás.
  2. Kattintson ide Download OpenAPI spec a tetejéről Keresési API oldal.
  3. Importáld a Postmanbe.
  4. Ha új gyűjteményként importáltad, amelynek neve Wink API, kattintson a gyűjtemény neve melletti vízszintes három pontra (3 pont), majd a Edit.
  5. A Authorization tab, állítsa be a Auth type az OAuth2-höz.
  6. Állítsa be a mezőt Add auth data to hogy Request headers.
  7. Állítsa be a mezőt Header prefix hogy Bearer.
  8. Állítsa be a mezőt Token Name arra a névre, amit a Postmanben el szeretnél nevezni a mentett tokenednek. Pl. Wink Staging.
  9. Állítsa be a mezőt Grant type hogy Client Credentials.
  10. Állítsa be a mezőt Access token URL a https://staging-iam.wink.travel/oauth2/token címre.
  11. Állítsa be a mezőt Client ID az alkalmazás által generált ügyfél-azonosítóhoz.
  12. Állítsa be a mezőt Client Secret az alkalmazásod által generált ügyféltitokhoz.
  13. Állítsa be a mezőt Scope hogy inventory.read inventory.write inventory.removeEzek az összes hatókörök, amire szükséged lesz a Winkhez.
  14. Állítsa be a mezőt Client Authentication hogy Send as Basic Auth header.
  15. Kattintson a Get New Access Token gombra a token lekéréséhez és mentéséhez.
  16. A Wink API gyűjtemény alatti összes API-hívásnál győződjön meg arról, hogy a hitelesítési lapon ez áll: Inherit auth from parent így minden hívásba belefoglalja a tokenedet.

:::tip[Profi tipp] Ajánlott a kiszolgáló domainjét, az ügyfél-azonosítót és az ügyfél titkos kulcsát környezeti változókba tenni. Így könnyen válthat a tesztelési és az éles környezetek között, és újra felhasználhatja az összes létrehozott műveletet. :::