Pāriet uz saturu
Wink

Uzstādīšana

Šis raksts parāda, kā ātri uzstādīties kā izstrādātājam un sākt testēt mūsu API Wink platformā.

Izpildiet šos soļus:

  1. Reģistrējiet savu lietotāja kontu Wink.
  2. Izveidojiet filiāles kontu. Jums tas būs nepieciešams, lai sasaistītu savu lietotni. Skatiet kas ir Studio papildu informācijai.
  3. Izveidojiet lietotni un sasaistiet to ar filiāles kontu, ko izveidojāt 2. solī. Servera-servera API integrācijām izvēlieties klienta tipu MACHINE_2_MACHINE.
  4. Kad esat izveidojis savu Application, nekavējoties nokopējiet un saglabājiet klienta ID un slepeno atslēgu — slepenā atslēga tiek parādīta tikai vienu reizi un to nevar atgūt.

CDN

Section titled “CDN”

Wink platformā 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 uzlabotajām funkcijām.

Mūsu cloud_name ir traveliko.

Cloudinary

Section titled “Cloudinary”

Piemērs

Section titled “Piemērs”

Katram ceļojumu inventāra tipam, ko atbalstām, būs iekšējs JSON masīvs ar nosaukumu multimedias. Multimediju ieraksta JSON 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"
    }
  ]
}

Augstāk izceltais rindiņa rāda Cloudinary unikālo ID partners/radisson_blu_logo. Tas ir viss, kas jums nepieciešams, lai iegūtu attēlu jebkurā formātā, kvalitātē un izmērā.

Testēšana

Section titled “Testēšana”

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

API dokumentācija

Section titled “API dokumentācija”

Mūsu dokumentācijas vietne ir izveidota tā, lai jūs varētu izpildīt API komandas tieši no vietnes.

Šajā piemērā jūs vēlaties izmantot Search Lookups (OAuth2) API izsaukumu.

  1. Izmantojiet Lookup 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 slepeno atslēgu un noklikšķiniet uz pogas Get TOKEN.
  4. Ja jūsu akreditācijas dati ir derīgi, redzēsiet, ka jūsu API atslēga ir piemērota.
  5. Tagad varat testēt lookup galapunktu.
Lookup API endpoint
Paraugs Search Lookups (OAuth2)

Postman

Section titled “Postman”

To pašu var izdarīt ar Postman.

  1. Lejupielādējiet Postman.
  2. Noklikšķiniet uz Download OpenAPI spec lapas augšpusē pie Lookup API.
  3. Importējiet to Postman.
  4. Ja importējāt to kā jaunu kolekciju ar nosaukumu Wink API, noklikšķiniet uz horizontālās elipses (3 punkti) blakus kolekcijas nosaukumam un izvēlieties Edit.
  5. Cilnē Authorization 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 uz jebkuru nosaukumu, ko vēlaties piešķirt saglabātajam tokenam 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, ko jūsu lietotne ģenerēja.
  12. Iestatiet lauku Client Secret uz slepeno atslēgu, ko jūsu lietotne ģenerēja.
  13. Iestatiet lauku Scope uz inventory.read inventory.write inventory.remove. Tie ir visi nepieciešamie piekļuves līmeņi Wink.
  14. Iestatiet lauku Client Authentication uz Send as Basic Auth header.
  15. Noklikšķiniet uz pogas Get New Access Token, lai iegūtu un saglabātu savu tokenu.
  16. Visos API izsaukumos Wink API kolekcijā pārliecinieties, ka autorizācijas cilnē ir iestatīts Inherit auth from parent, lai katrā izsaukumā tiktu iekļauts jūsu tokens.