Setup

Þessi grein sýnir þér hvernig á að koma sér fljótt fyrir sem forritari og byrja að prófa API-viðmótin okkar á Wink.

:::athugið Prófanir ættu alltaf að fara fram í okkarsviðsetningarumhverfiÞað eru miklu minni gögn þar en þú ert frjáls til að prófa eins mikið og þú vilt án þess að það skipti miklu máli fyrir framleiðsluumhverfið.

Þegar þú ert tilbúinn/tilbúin til að fara í loftið, munum við votta aðganginn þinn og forritið og þú getur ræst það í framleiðsluumhverfi okkar. :::

Fylgdu þessum skrefum:

1. Skráning notandareikningurinn þinn á Wink
2. Búa til reikningur ferðaskrifstofu eða tengdareikningur.
3. Búa til umsókn þar sem þú tengir það við reikninginn sem þú bjóst til í skrefi 2.
4. Þegar þú hefur búið til þitt Application, vistaðu viðskiptavinaauðkennið og leyndarmál viðskiptavinar á öruggum stað.

CDN

Hjá Wink notum við Cloudinary fyrir allar myndir og myndbönd okkar. Þegar þú opnar ferðasafnið okkar færðu aðgang að öllum háþróuðum eiginleikum Cloudinary.

Okkarcloud_nameertraveliko.

Skýjað

• Að byrja
• SDK-verkefni
• Cloudinary á GitHub
• Myndbandsleiðbeiningar

Dæmi

Fyrir hverja ferðaskráartegund sem við styðjum verður innfelld JSON-fylki sem kallastmultimediasJSON skráin fyrir margmiðlunarfærslu 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"
    }
  ]
}

Merkta línan hér að ofan sýnir einstaka auðkenni Cloudinarypartners/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

Farðu yfir til okkarAPI-viðmótkaflanum og veldu API-ið sem þú vilt vinna með.

API skjöl

Skjalasíða okkar er sett upp þannig að þú getur keyrt API skipanir innan síðunnar.

Í þessu dæmi viltu notaSearch Lookups (OAuth2)API-kall.

:::ráð[Fagráð] Til að auðvelda notkun mælum við með að samþættingaraðilar noti endapunktana sem við tilnefnum semOAuth2Þessir endapunktar vita að búast má við API-köllum og vita nú þegar hvaða reikning þú ert á svo þú þarft ekki að tilgreina það.companyIdentifierí vefslóðunum þínum. :::

1. Notaðu Leitarforritaskil til að sækja áfangastaði eða hótel.
2. Í vinstri yfirlitsstikunni smellirðu á Authentication.
3. Sláðu inn viðskiptavinaauðkenni þitt og leyndarmál viðskiptavinar og smelltu á Get TOKEN hnappur.
4. Ef innskráningarupplýsingar þínar eru gildar, munt þú sjá að API lykillinn þinn hefur verið notaður.
5. Nú er hægt að prófa uppflettingarendapunktinn.

Dæmi um leitarleit (OAuth2)

Póstberi

Þú getur gert það sama með Póstmanninn.

1. Sækja Póstberi.
2. Smelltu á Download OpenAPI spec frá toppnum á Leitarforritaskil síðu.
3. Flytja það inn í Postman.
4. Ef þú fluttir það inn sem nýtt safn sem kallast Wink API, smelltu á lárétta þrípunktinn (3 punktar) við hliðina á nafni safnsins og smelltu á Edit.
5. Í Authorization tab, stilltu Auth type til OAuth2.
6. Setja reitinn Add auth data to til Request headers.
7. Setja reitinn Header prefix til Bearer.
8. Setja reitinn Token Name hverju nafni sem þú vilt gefa vistaða táknið þitt í Postman. T.d. Wink Staging.
9. Setja reitinn Grant type til Client Credentials.
10. Setja reitinn Access token URL á https://staging-iam.wink.travel/oauth2/token.
11. Setja reitinn Client ID við viðskiptavinaauðkennið sem appið þitt hjálpaði til við að búa til.
12. Setja reitinn Client Secret við leyndarmál viðskiptavinarins sem appið þitt hjálpaði til við að mynda.
13. Setja reitinn Scope til inventory.read inventory.write inventory.removeÞetta eru öll þau sjónsvið sem þú þarft fyrir Wink.
14. Setja reitinn Client Authentication til Send as Basic Auth header.
15. Smelltu á Get New Access Token hnappinn til að sækja táknið þitt og vista það.
16. Fyrir öll API-köll innan Wink API-safnsins, vertu viss um að auðkenningarflipinn segi Inherit auth from parent svo það fylgir táknið þitt með í hverju símtali.

:::ráð[Fagráð] Mælt er með að breyta léni netþjónsins, viðskiptavinaauðkenni og leyndarmáli viðskiptavinar í umhverfisbreytur. Þannig er auðvelt að skipta á milli sviðsetningar- og framleiðsluumhverfis og endurnýta allar aðgerðir sem þú hefur búið til. :::