Setup

Šajā rakstā parādīts, kā ātri kļūt par izstrādātāju un sākt testēt mūsu API platformā Wink.

:::piezīme Testēšanai vienmēr jānotiek mūsuiestudējuma videTur ir daudz mazāk datu, taču jūs varat brīvi testēt tik daudz, cik vēlaties, nepārslogojot ražošanas vidi.

Kad būsiet gatavs sākt darbu tiešsaistē, mēs sertificēsim jūsu kontu un lietojumprogrammu, un jūs varēsiet palaist to mūsu ražošanas vidē. :::

Veiciet šīs darbības:

1. Reģistrēties jūsu lietotāja konts vietnē Wink
2. Izveidot ceļojumu aģenta konts vai filiāles konts.
3. Izveidojiet lietojumprogrammu kur to saistāt ar kontu, ko izveidojāt 2. darbībā.
4. Kad esat izveidojis savu Application, saglabājiet klienta ID un klienta noslēpumu drošā vietā.

CDN

Wink mēs izmantojam Cloudinary visiem mūsu attēlu un video resursiem. Piekļūstot mūsu ceļojumu inventāram, jums būs pilnīga piekļuve visām Cloudinary papildu funkcijām.

Mūsucloud_nameirtraveliko.

Mākoņainais

• Darba sākšana
• SDK
• Cloudinary vietnē GitHub
• Video pamācības

Piemērs

Katram mūsu atbalstītajam ceļojumu inventāra veidam būs ligzdots JSON masīvs ar nosaukumumultimediasMultivides ieraksta JSON fails izskatās šādi:

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

Iepriekš iezīmētā rinda parāda Cloudinary unikālo IDpartners/radisson_blu_logoTas ir viss, kas jums nepieciešams, lai izgūtu attēlu jebkurā vēlamajā formātā, kvalitātē un izmērā.

Testēšana

Dodieties uz mūsuAPIsadaļu un izvēlieties API, ar kuru vēlaties strādāt.

API dokumentācija

Mūsu dokumentācijas vietne ir izveidota tā, lai jūs varētu palaist API komandas no vietnes iekšienes.

Šajā piemērā vēlaties izmantotSearch Lookups (OAuth2)API izsaukums.

:::tip[Profesionāls padoms] Lietošanas ērtībai integratoriem iesakām izmantot galapunktus, ko mēs apzīmējam kāOAuth2Šie galapunkti zina, ka jāgaida API izsaucēji, un jau zina, kurā kontā jūs atrodaties, tāpēc jums tas nav jānorāda.companyIdentifierjūsu URL. :::

1. Izmantojiet Meklēšanas API lai izgūtu galamērķus vai viesnīcas.
2. Kreisajā navigācijas joslā noklikšķiniet uz Authentication.
3. Ievadiet savu klienta ID un klienta noslēpumu un noklikšķiniet uz Get TOKEN poga.
4. Ja jūsu akreditācijas dati ir derīgi, jūs redzēsiet, ka jūsu API atslēga ir lietota.
5. Tagad varat pārbaudīt meklēšanas galapunktu.

Meklēšanas paraugu uzmeklēšana (OAuth2)

Pastnieks

To pašu var izdarīt ar Postman.

1. Lejupielādēt Pastnieks.
2. Noklikšķiniet uz Download OpenAPI spec no augšas Meklēšanas API lapa.
3. Importējiet to programmā Postman.
4. Ja importējāt to kā jaunu kolekciju ar nosaukumu Wink API, noklikšķiniet uz horizontālās daudzzīmes (3 punkti) blakus kolekcijas nosaukumam un noklikšķiniet uz Edit.
5. Iekšpusē Authorization tab, iestatiet Auth type uz OAuth2.
6. Iestatiet lauku Add auth data to uz Request headers.
7. Iestatiet lauku Header prefix uz Bearer.
8. Iestatiet lauku Token Name kā vien vēlaties nosaukt savu saglabāto žetonu programmā Postman. Piemēram, Wink Staging.
9. Iestatiet lauku Grant type uz Client Credentials.
10. Iestatiet lauku Access token URL uz https://staging-iam.wink.travel/oauth2/token.
11. Iestatiet lauku Client ID uz klienta ID, kura ģenerēšanā jūsu lietotne palīdzēja.
12. Iestatiet lauku Client Secret klienta noslēpumam, kuru jūsu lietotne palīdzēja ģenerēt.
13. Iestatiet lauku Scope uz inventory.read inventory.write inventory.removeTie ir visi darbības jomas, kas jums būs nepieciešamas Wink.
14. Iestatiet lauku Client Authentication uz Send as Basic Auth header.
15. Noklikšķiniet uz Get New Access Token pogu, lai izgūtu savu žetonu un saglabātu to.
16. Visiem API izsaukumiem Wink API kolekcijā pārliecinieties, vai autentifikācijas cilnē ir norādīts Inherit auth from parent tāpēc tas iekļauj jūsu žetonu katrā izsaukumā.

:::tip[Profesionāls padoms] Ieteicams servera domēnu, klienta ID un klienta slepeno atslēgu iekļaut vides mainīgajos. Tādā veidā jūs varat viegli pārslēgties starp izstrādes un ražošanas vidi un atkārtoti izmantot visas izveidotās darbības. :::