Pāriet uz saturu
Wink

Uzstādīšana

Šajā rakstā ir parādīts, kā ātri uzstādīties kā izstrādātājam un sākt testēt mūsu API vietnē Wink.

Izpildiet šīs darbības:

  1. Reģistrējiet savu lietotāja kontu vietnē Wink.
  2. Izveidojiet filiāles kontu. Jums tas būs nepieciešams, lai sasaistītu savu lietojumprogrammu. Skatiet kas ir Studio papildu kontekstam.
  3. Izveidojiet lietojumprogrammu 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 izmanto Cloudinary visiem 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ā, kādu vēlaties.

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
Parauga 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.
  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 norādiet jebkuru nosaukumu jūsu saglabātajam 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 klienta slepeno atslēgu, ko jūsu lietotne ģenerēja.
  13. Laukā Scope ievadiet ar atstarpēm atdalītos piekļuves apjomus, kas nepieciešami jūsu integrācijai (piemēram, inventory.read inventory.write inventory.remove). Skatiet apjomu 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.