Setup

Ipinapakita sa iyo ng artikulong ito kung paano mabilis na makapag-set up bilang isang developer at simulan ang pagsubok sa aming mga API sa Wink.

Ang pagsubok ay dapat palaging mangyari sa ating kapaligiran ng pagtatanghal. Mayroong mas kaunting data doon ngunit malaya kang sumubok hangga’t gusto mo nang hindi nagpapataw sa kapaligiran ng produksyon.

Kapag handa ka nang mag-live, ise-certify namin ang iyong account at ang iyong aplikasyon at maaari kang maglunsad sa aming kapaligiran sa produksyon.

Sundin ang mga hakbang na ito:

1. Magrehistro iyong user account sa Wink
2. Lumikha ng a account ng ahente sa paglalakbay o isang kaakibat na account.
3. Gumawa ng Application kung saan mo ito iniuugnay sa account na iyong ginawa sa Hakbang 2.
4. Kapag nagawa mo na ang iyong Application, i-save ang client-id at client secret sa isang ligtas na lugar.

CDN

Sa Wink, ginagamit namin ang Cloudinary para sa lahat ng aming mga asset ng larawan at video. Kapag na-access mo ang aming imbentaryo sa paglalakbay, magkakaroon ka ng ganap na access sa lahat ng advanced na feature ng Cloudinary.

Ang aming cloud_name ay traveliko.

Maulap

• Pagsisimula
• Mga SDK
• Cloudinary sa GitHub
• Mga Tutorial sa Video

Halimbawa

Para sa bawat uri ng imbentaryo ng paglalakbay na sinusuportahan namin, magkakaroon ng nested JSON array na tinatawag multimedias. Ang JSON para sa isang multimedia entry ay ganito ang hitsura:

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

Ipinapakita ng naka-highlight na linya sa itaas ang natatanging ID ng Cloudinary partners/radisson_blu_logo. Iyon lang ang kailangan mo upang makuha ang larawan sa anumang format, kalidad at sukat na gusto mo.

Pagsubok

Pumunta sa aming Mga API seksyon at piliin ang API na gusto mong gamitin.

Mga doc ng API

Ang aming site ng dokumentasyon ay naka-set up sa paraang maaari kang magpatakbo ng mga API command mula sa loob ng site.

Sa halimbawang ito, gusto mong gamitin ang Search Lookups (OAuth2) API na tawag.

:::tip[Pro Tip] Para sa kadalian ng paggamit, inirerekomenda namin na gamitin ng mga integrator ang mga endpoint na itinalaga namin bilang OAuth2. Alam ng mga endpoint na iyon na asahan ang mga tumatawag sa API at alam na nila kung saang account ka naroroon kaya hindi mo na kailangang tukuyin ang companyIdentifier sa iyong mga URL. :::

1. Gamitin ang Lookup API upang makuha ang mga destinasyon o hotel.
2. Sa kaliwang navbar, mag-click sa Authentication.
3. Ilagay ang iyong client-id at client secret at i-click ang Get TOKEN pindutan.
4. Kung valid ang iyong mga kredensyal, makikita mong nailapat na ang iyong API key.
5. Maaari mo na ngayong subukan ang lookup endpoint.

Sample Search Lookups (OAuth2)

Postman

Maaari mong gawin ang parehong bagay sa Postman.

1. I-download Postman.
2. Mag-click sa Download OpenAPI spec mula sa tuktok ng Lookup API pahina.
3. I-import ito sa Postman.
4. Kung na-import mo ito bilang isang bagong koleksyon na tinatawag na Wink API, mag-click sa pahalang na elipsis (3 tuldok) sa tabi ng pangalan ng koleksyon at i-click Edit.
5. Sa Authorization tab, itakda ang Auth type sa OAuth2.
6. Itakda ang field Add auth data to sa Request headers.
7. Itakda ang field Header prefix sa Bearer.
8. Itakda ang field Token Name sa anumang nais mong pangalanan ang iyong na-save na token sa Postman. Hal. Wink Staging.
9. Itakda ang field Grant type sa Client Credentials.
10. Itakda ang field Access token URL sa https://staging-iam.wink.travel/oauth2/token.
11. Itakda ang field Client ID sa Client ID na nakatulong sa pagbuo ng iyong app.
12. Itakda ang field Client Secret sa Lihim ng Kliyente na nakatulong sa pagbuo ng iyong app.
13. Itakda ang field Scope sa inventory.read inventory.write inventory.remove. Iyan ang lahat ng mga saklaw na kakailanganin mo para sa Wink.
14. Itakda ang field Client Authentication sa Send as Basic Auth header.
15. I-click ang Get New Access Token button upang makuha ang iyong token at i-save ito.
16. Para sa lahat ng mga tawag sa API sa ilalim ng koleksyon ng Wink API, tiyaking sinasabi ng tab ng pagpapatotoo Inherit auth from parent kaya kasama nito ang iyong token sa bawat tawag.

:::tip[Pro Tip] Inirerekomenda na gawing lihim ang domain ng server, client ID at client sa mga variable ng kapaligiran. Sa ganoong paraan madali kang makakapagpalipat-lipat sa pagitan ng staging at production environment at muling magagamit ang lahat ng mga operasyong ginawa mo. :::