Setup

See artikkel näitab teile, kuidas kiiresti arendajana end seadistada ja meie API-sid Winkis testima hakata.

:::märkus Testimine peaks alati toimuma meielavastuskeskkondSeal on palju vähem andmeid, aga sa võid vabalt testida nii palju kui soovid, ilma et see tootmiskeskkonda koormaks.

Kui olete valmis avaldama, sertifitseerime teie konto ja rakenduse ning saate selle meie tootmiskeskkonnas käivitada. :::

Järgige neid samme:

1. Registreeru teie kasutajakonto Winkis
2. Loo reisibüroo konto või partnerkonto.
3. Loo rakendus kus te selle 2. sammus loodud kontoga seostate.
4. Kui olete loonud oma Application, salvesta kliendi ID ja kliendi saladus kindlasse kohta.

CDN

Winkis kasutame kõigi oma pildi- ja videomaterjalide jaoks Cloudinaryt. Meie reisimaterjalide inventarile ligipääsemisel on teil täielik juurdepääs kõigile Cloudinary täiustatud funktsioonidele.

Meiecloud_nameontraveliko.

Pilvepõhine

• Alustamine
• SDK-d
• Cloudinary GitHubis
• Videoõpetused

Näide

Iga meie toetatava reisivarustuse tüübi kohta on olemas pesastatud JSON-massiiv nimegamultimediasMultimeediakirje JSON näeb välja selline:

{
  "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"
    }
  ]
}

Ülaltoodud esiletõstetud rida näitab Cloudinary unikaalset ID-d.partners/radisson_blu_logoSee on kõik, mida vajate pildi hankimiseks mis tahes vormingus, kvaliteedis ja suuruses.

Testimine

Mine meie juurdeAPI-dja valige API, millega soovite töötada.

API dokumendid

Meie dokumentatsioonisait on üles ehitatud nii, et saate saidi seest käivitada API-käske.

Selles näites soovite kasutadaSearch Lookups (OAuth2)API-kõne.

:::tip[Proffi nipp] Lihtsuse huvides soovitame integraatoritel kasutada meie määratud lõpp-punkteOAuth2Need lõpp-punktid teavad, et oodata API-kõnesid ja teavad juba, millisel kontol te olete, seega ei pea te seda täpsustama.companyIdentifierteie URL-ides. :::

1. Kasutage Otsingu API sihtkohtade või hotellide leidmiseks.
2. Vasakpoolsel navigeerimisribal klõpsake nuppu Authentication.
3. Sisestage oma kliendi ID ja kliendi salakood ning klõpsake nuppu Get TOKEN nupp.
4. Kui teie volitused on kehtivad, näete, et teie API-võti on rakendatud.
5. Nüüd saate otsingu lõpp-punkti testida.

Näidisotsingu päringud (OAuth2)

Postiljon

Sama saab teha ka Postmaniga.

1. Laadi alla Postiljon.
2. Klõpsake Download OpenAPI spec ülaosast Otsingu API leht.
3. Impordi see Postmani.
4. Kui importisite selle uue kollektsioonina nimega Wink API, klõpsake kollektsiooni nime kõrval asuval horisontaalsel kolmikpunktil (3 punkti) ja seejärel klõpsake Edit.
5. Sisse Authorization tab, määrake Auth type OAuth2-le.
6. Määrake väli Add auth data to kuni Request headers.
7. Määrake väli Header prefix kuni Bearer.
8. Määrake väli Token Name ükskõik milliseks nimeks sa oma salvestatud tokenile Postmanis anda soovid. Näiteks Wink Staging.
9. Määrake väli Grant type kuni Client Credentials.
10. Määrake väli Access token URL aadressile https://staging-iam.wink.travel/oauth2/token.
11. Määrake väli Client ID kliendi ID-le, mille genereerimisel teie rakendus osales.
12. Määrake väli Client Secret kliendi saladusele, mille loomisel teie rakendus osales.
13. Määrake väli Scope kuni inventory.read inventory.write inventory.removeNeed on kõik ulatused, mida Winki jaoks vaja läheb.
14. Määrake väli Client Authentication kuni Send as Basic Auth header.
15. Klõpsake nuppu Get New Access Token nupp oma tokeni hankimiseks ja salvestamiseks.
16. Kõikide Wink API kollektsiooni all olevate API-kõnede puhul veenduge, et autentimise vahekaardil oleks kirjas Inherit auth from parent seega lisab see teie tokeni iga kõnega.

:::tip[Proffi nipp] Soovitatav on muuta serveri domeen, kliendi ID ja kliendi salakood keskkonnamuutujateks. Nii saate hõlpsalt vahetada testimis- ja tootmiskeskkondade vahel ning taaskasutada kõiki loodud toiminguid. :::