Pāriet uz saturu
Academy

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 vietnē Wink.

Izpildiet šos soļus:

  1. Reģistrējiet savu lietotāja kontu vietnē Wink
  2. Izveidojiet ceļojumu aģenta kontu vai afilācijas kontu.
  3. Izveidojiet lietotni, kurā saistāt to ar kontu, ko izveidojāt 2. solī.
  4. Kad esat izveidojis savu Application, saglabājiet klienta ID un klienta slepeno atslēgu drošā vietā.

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 izgū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 klienta 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 galapunkts
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. 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 palīdzēja ģenerēt.
  12. Iestatiet lauku Client Secret uz klienta slepeno atslēgu, ko jūsu lietotne palīdzēja ģenerēt.
  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 izgūtu savu tokenu un saglabātu to.
  16. Visos API izsaukumos Wink API kolekcijā pārliecinieties, ka autorizācijas cilnē ir norādīts Inherit auth from parent, lai katrā izsaukumā tiktu iekļauts jūsu tokens.