Stökkva að meginefni

Uppsetning

Þessi grein sýnir þér hvernig þú getur fljótt sett þig upp sem verktaki og byrjað að prófa API-in okkar á Wink.

Fylgdu þessum skrefum:

  1. Skráðu þig með notandareikningnum þínum á Wink.
  2. Búðu til tengdan reikning. Þú þarft hann til að tengja Umsóknina þína við. Sjáðu hvað er Markaðssetning fyrir frekari upplýsingar.
  3. Búðu til Umsókn og tengdu hana við tengdan reikninginn sem þú bjóst til í skrefi 2. Fyrir server-to-server API samþættingar skaltu velja MACHINE_2_MACHINE sem viðskiptavinatýpu.
  4. Þegar þú hefur búið til Umsóknina, afritaðu og vistaðu client-id og leynilykilinn strax — leynilykillinn er sýndur aðeins einu sinni og er ekki hægt að nálgast aftur.

Hjá Wink notum við Cloudinary fyrir öll mynd- og myndbandsgögn okkar. Þegar þú nálgast ferðavörulistann okkar færðu fullan aðgang að öllum háþróuðum eiginleikum Cloudinary.

cloud_name okkar er traveliko.

Fyrir hvern ferðavörutegund sem við styðjum verður til staðar innfelld JSON fylki sem kallast multimedias. JSON fyrir fjölmiðlaatriði lítur svona út:

{
"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"
}
]
}

Línan sem er merkt sýnir einstakt Cloudinary auðkenni partners/radisson_blu_logo. Þetta er allt sem þú þarft til að sækja myndina í hvaða sniði, gæðum og stærð sem þú vilt.

Farðu á API-síðuna okkar og veldu API-ið sem þú vilt vinna með.

Skjölunarsíðan okkar er uppsett þannig að þú getur keyrt API skipanir beint innan síðunnar.

Í þessu dæmi viltu nota Search Lookups (OAuth2) API kallið.

  1. Notaðu Lookup API til að sækja áfangastaði eða hótel.
  2. Í vinstri valmynd, smelltu á Authentication.
  3. Sláðu inn client-id og client secret og smelltu á Get TOKEN hnappinn.
  4. Ef auðkennin þín eru gild sérðu að API lykillinn þinn hefur verið virkjaður.
  5. Þú getur nú prófað lookup endapunktinn.
Lookup API endpoint
Dæmi um Search Lookups (OAuth2)

Þú getur gert það sama með Postman.

  1. Sæktu Postman.
  2. Smelltu á Download OpenAPI spec efst á Lookup API síðunni.
  3. Flyttu það inn í Postman.
  4. Ef þú fluttir það inn sem nýja safn sem heitir Wink API, smelltu á lárétta þrennu (3 punktar) við hlið safnsins og veldu Edit.
  5. Í Authorization flipanum, stilltu Auth type á OAuth2.
  6. Stilltu reitinn Add auth data to á Request headers.
  7. Stilltu reitinn Header prefix á Bearer.
  8. Stilltu reitinn Token Name á það nafn sem þú vilt gefa vistaða tokeninu í Postman, t.d. Wink Staging.
  9. Stilltu reitinn Grant type á Client Credentials.
  10. Stilltu reitinn Access token URL á https://staging-iam.wink.travel/oauth2/token.
  11. Stilltu reitinn Client ID á Client ID sem umsóknin þín hjálpaði til við að búa til.
  12. Stilltu reitinn Client Secret á Client Secret sem umsóknin þín hjálpaði til við að búa til.
  13. Stilltu reitinn Scope á þau svæði sem samþættingin þín þarf (t.d. inventory.read inventory.write inventory.remove). Sjáðu yfirlit yfir svæði fyrir fulla lista.
  14. Stilltu reitinn Client Authentication á Send as Basic Auth header.
  15. Smelltu á Get New Access Token hnappinn til að sækja tokenið þitt og vista það.
  16. Fyrir öll API köll undir Wink API safninu, vertu viss um að auðkenningarflipinn segi Inherit auth from parent svo tokenið þitt fylgi með í hverju kalli.