Skip to content
Wink

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ð notendareikningnum þínum á Wink.
  2. Búðu til tengdan reikning. Þú þarft hann til að tengja Umsóknina þína við. Sjáðu hvað er Studio fyrir frekari upplýsingar.
  3. Búðu til Umsókn og tengdu hana við tengda reikninginn sem þú bjóst til í skrefi 2. Fyrir server-to-server API samþættingar, veldu MACHINE_2_MACHINE sem viðskiptavinagerð.
  4. Þegar þú hefur búið til Application, 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.

CDN

Section titled “CDN”

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

cloud_name okkar er traveliko.

Cloudinary

Section titled “Cloudinary”

Dæmi

Section titled “Dæmi”

Fyrir hvern ferðatöflu-flokk sem við styðjum, er innbyggður JSON fylki kallað 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. Það er allt sem þú þarft til að sækja myndina í hvaða sniði, gæðum og stærð sem þú vilt.

Prófanir

Section titled “Prófanir”

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

API skjöl

Section titled “API skjöl”

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

Í þ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ðkenni þí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)

Postman

Section titled “Postman”

Þú 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 appið þitt hjálpaði til við að búa til.
  12. Stilltu reitinn Client Secret á Client Secret sem appið þitt 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 scope tilvísunina 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ðkenningaflipinn segi Inherit auth from parent svo tokenið fylgi með í hverju kalli.