Pāriet uz saturu

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 lietotni. Skatiet kas ir Mārketings plašākai 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 kopējiet un saglabājiet klienta ID un slepeno atslēgu — slepenā atslēga tiek parādīta tikai vienreiz un to nevar atkārtoti iegūt.

Wink izmanto Cloudinary visiem attēlu un video materiāliem. 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.

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": "Vestibils",
"description": "Vestibila attēls",
"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ā.

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

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 galapunkts
Parauga Search Lookups (OAuth2)

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, kādu vēlaties saglabāt savam 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 klienta slepeno atslēgu, ko jūsu lietotne ģenerēja.
  13. Iestatiet lauku Scope uz ar atstarpēm atdalītajiem piekļuves līmeņiem, kas nepieciešami jūsu integrācijai (piemēram, inventory.read inventory.write inventory.remove). Skatiet scope atsauci pilnai sarakstam.
  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. Visām API izsaukumiem 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.