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 vienreiz un to vairs nevarēs iegūt.

CDN

Section titled “CDN”

Wink izmanto 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 veidam, 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ā 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ē Lookup API lapā.
  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. Laukā Add auth data to iestatiet uz Request headers.
  7. Laukā Header prefix iestatiet uz Bearer.
  8. Laukā Token Name ierakstiet jebkuru nosaukumu, kādu vēlaties saglabāt savam tokenam Postman. Piemēram, Wink Staging.
  9. Laukā Grant type iestatiet uz Client Credentials.
  10. Laukā Access token URL iestatiet https://staging-iam.wink.travel/oauth2/token.
  11. Laukā Client ID ievadiet klienta ID, ko jūsu lietotne ģenerēja.
  12. Laukā Client Secret ievadiet slepeno atslēgu, ko jūsu lietotne ģenerēja.
  13. Laukā Scope ievadiet ar atstarpēm atdalītos piekļuves līmeņus, kas nepieciešami jūsu integrācijai (piemēram, inventory.read inventory.write inventory.remove). Skatiet scope atsauci pilnai sarakstam.
  14. Laukā Client Authentication iestatiet uz Send as Basic Auth header.
  15. Noklikšķiniet uz pogas Get New Access Token, lai saņemtu 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.