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 travel agent account o isang affiliate account.
3. Gumawa ng Application kung saan ia-associate mo ito sa account na ginawa mo sa Hakbang 2.
4. Kapag nagawa mo na ang iyong Application, itago nang ligtas ang client-id at client secret.

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 lang ang kailangan mo para 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 tinatawag naming OAuth2. Alam ng mga endpoint na ito na may API callers at alam na kung anong account ka kaya hindi mo na kailangang tukuyin ang companyIdentifier sa iyong mga URL.

1. Gamitin ang Lookup API para 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 nilikha ng iyong app.
12. Itakda ang field na Client Secret sa Client Secret na nilikha ng iyong app.
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 para 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 para 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-palit sa pagitan ng staging at production environments at magagamit muli ang lahat ng operasyon na iyong ginawa.