Setup

Ipinapakita ng artikulong ito kung paano ka mabilis na makakapagsimula bilang developer at makakapagsimulang subukan ang aming mga API sa Wink.

Note

Dapat palaging isagawa ang pagsubok sa aming staging environment. Mas kaunti ang data doon ngunit malaya kang mag-test nang marami hangga’t gusto mo nang hindi naaapektuhan ang production environment.

Kapag handa ka nang mag-live, ise-certify namin ang iyong account at ang iyong application at maaari mo nang ilunsad ito sa aming production environment.

Sundin ang mga hakbang na ito:

1. Magrehistro ng iyong user account sa Wink.
2. Gumawa ng affiliate account. Kakailanganin mo ito upang i-bind ang iyong Application. Tingnan ang ano ang Studio para sa karagdagang konteksto.
3. Gumawa ng Application at iugnay ito sa affiliate account na ginawa mo sa Hakbang 2. Para sa server-to-server API integrations, piliin ang MACHINE_2_MACHINE bilang client type.
4. Kapag nagawa mo na ang iyong Application, kopyahin at i-save agad ang client-id at secret key — ang secret key ay ipinapakita lamang isang beses at hindi na maaaring makuha muli.

CDN

Sa Wink, ginagamit namin ang Cloudinary para sa lahat ng aming mga image at video assets. Kapag na-access mo ang aming travel inventory, magkakaroon ka ng buong access sa lahat ng advanced na features ng Cloudinary.

Ang aming cloud_name ay traveliko.

Cloudinary

• Pagsisimula
• SDKs
• Cloudinary sa GitHub
• Video Tutorials

Halimbawa

Para sa bawat uri ng travel inventory na sinusuportahan namin, mayroong nested JSON array na tinatawag na multimedias. Ganito ang hitsura ng JSON para sa isang multimedia entry:

{
  "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 Cloudinary unique ID na partners/radisson_blu_logo. Iyan lamang ang kailangan mo upang makuha ang imahe sa anumang format, kalidad, at sukat na gusto mo.

Pagsubok

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

API docs

Ang aming documentation site ay nakaayos sa paraang maaari kang magpatakbo ng mga API command mula mismo sa site.

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

Pro Tip

Para sa mas madaling paggamit, inirerekomenda naming gamitin ng mga integrator ang mga endpoint na tinukoy namin bilang OAuth2. Alam ng mga endpoint na ito na inaasahan ang mga API caller at alam na kung anong account ka kaya hindi mo na kailangang tukuyin ang companyIdentifier sa iyong mga URL.

1. Gamitin ang Lookup API upang kunin ang mga destinasyon o hotel.
2. Sa kaliwang navbar, i-click ang Authentication.
3. Ilagay ang iyong client-id at client secret at i-click ang Get TOKEN button.
4. Kung tama ang iyong mga kredensyal, makikita mong na-apply na ang iyong API key.
5. Maaari mo nang subukan ang lookup endpoint.

Halimbawang Search Lookups (OAuth2)

Postman

Maaari mo ring gawin ang parehong bagay gamit ang Postman.

1. I-download ang Postman.
2. I-click ang Download OpenAPI spec mula sa itaas ng Lookup API na pahina.
3. I-import ito sa Postman.
4. Kung na-import mo ito bilang bagong koleksyon na tinatawag na Wink API, i-click ang horizontal ellipsis (3 tuldok) sa tabi ng pangalan ng koleksyon at i-click ang Edit.
5. Sa Authorization tab, itakda ang Auth type sa OAuth2.
6. Itakda ang field na Add auth data to sa Request headers.
7. Itakda ang field na Header prefix sa Bearer.
8. Itakda ang field na Token Name sa anumang gusto mong pangalanan ang iyong na-save na token sa Postman. Halimbawa, Wink Staging.
9. Itakda ang field na Grant type sa Client Credentials.
10. Itakda ang field na Access token URL sa https://staging-iam.wink.travel/oauth2/token.
11. Itakda ang field na Client ID sa Client ID na tinulungan ng iyong app na mabuo.
12. Itakda ang field na Client Secret sa Client Secret na tinulungan ng iyong app na mabuo.
13. Itakda ang field na Scope sa inventory.read inventory.write inventory.remove. Iyan ang lahat ng scopes na kakailanganin mo para sa Wink.
14. Itakda ang field na 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 API calls sa ilalim ng Wink API collection, siguraduhing ang authentication tab ay nagsasabing Inherit auth from parent upang maisama ang iyong token sa bawat tawag.

Pro Tip

Inirerekomenda na gawing environment variables ang server domain, client ID, at client secret. Sa ganitong paraan, madali kang makakapagpalit sa pagitan ng staging at production environments at magagamit muli ang lahat ng mga operasyon na iyong ginawa.