Skip to content
Academy

Persediaan

Artikel ini menunjukkan cara anda boleh menyediakan akaun sebagai pembangun dengan cepat dan mula menguji API kami di Wink.

Ikuti langkah-langkah berikut:

  1. Daftar akaun pengguna anda di Wink
  2. Cipta akaun ejen pelancongan atau akaun afiliasi.
  3. Cipta Aplikasi di mana anda mengaitkannya dengan akaun yang anda cipta di Langkah 2.
  4. Setelah anda mencipta Application, simpan client-id dan client secret di tempat yang selamat.

CDN

Section titled “CDN”

Di Wink, kami menggunakan Cloudinary untuk semua aset imej dan video kami. Apabila anda mengakses inventori pelancongan kami, anda akan mempunyai akses penuh kepada semua ciri lanjutan Cloudinary.

cloud_name kami ialah traveliko.

Cloudinary

Section titled “Cloudinary”

Contoh

Section titled “Contoh”

Untuk setiap jenis inventori pelancongan yang kami sokong, akan ada tatasusunan JSON bersarang yang dipanggil multimedias. JSON untuk entri multimedia kelihatan seperti ini:

{
  "multimediaIdentifier": "multimedia-1",
  "identifier": "partners/radisson_blu_logo",
  "type": "IMAGE",
  "width": "1024",
  "height": "768",
  "category": "1",
  "descriptions": [
    {
      "name": "Lobby",
      "description": "Gambar lobi",
      "language": "en"
    }
  ],
  "lifestyleType": "LIFESTYLE_BUSINESS",
  "attribution": [
    {
      "url": "https://www.hilton.com",
      "name": "Hilton"
    }
  ]
}

Baris yang diserlahkan di atas menunjukkan ID unik Cloudinary partners/radisson_blu_logo. Itu sahaja yang anda perlukan untuk mendapatkan imej dalam apa jua format, kualiti dan saiz yang anda mahu.

Ujian

Section titled “Ujian”

Teruskan ke bahagian API kami dan pilih API yang anda ingin gunakan.

Dokumen API

Section titled “Dokumen API”

Laman dokumentasi kami disediakan supaya anda boleh menjalankan arahan API terus dari dalam laman tersebut.

Dalam contoh ini, anda ingin menggunakan panggilan API Search Lookups (OAuth2).

  1. Gunakan Lookup API untuk mendapatkan destinasi atau hotel.
  2. Di navbar kiri, klik pada Authentication.
  3. Masukkan client-id dan client secret anda dan klik butang Get TOKEN.
  4. Jika kelayakan anda sah, anda akan melihat kunci API anda telah digunakan.
  5. Anda kini boleh menguji titik akhir lookup.
Titik akhir Lookup API
Contoh Search Lookups (OAuth2)

Postman

Section titled “Postman”

Anda boleh melakukan perkara yang sama menggunakan Postman.

  1. Muat turun Postman.
  2. Klik pada Download OpenAPI spec dari bahagian atas halaman Lookup API.
  3. Import ke dalam Postman.
  4. Jika anda mengimportnya sebagai koleksi baru bernama Wink API, klik pada elipsis mendatar (3 titik) di sebelah nama koleksi dan klik Edit.
  5. Dalam tab Authorization, tetapkan Auth type kepada OAuth2.
  6. Tetapkan medan Add auth data to kepada Request headers.
  7. Tetapkan medan Header prefix kepada Bearer.
  8. Tetapkan medan Token Name kepada apa sahaja nama yang anda mahu untuk token yang disimpan dalam Postman. Contohnya Wink Staging.
  9. Tetapkan medan Grant type kepada Client Credentials.
  10. Tetapkan medan Access token URL kepada https://staging-iam.wink.travel/oauth2/token.
  11. Tetapkan medan Client ID kepada Client ID yang aplikasi anda bantu hasilkan.
  12. Tetapkan medan Client Secret kepada Client Secret yang aplikasi anda bantu hasilkan.
  13. Tetapkan medan Scope kepada inventory.read inventory.write inventory.remove. Itu semua skop yang anda perlukan untuk Wink.
  14. Tetapkan medan Client Authentication kepada Send as Basic Auth header.
  15. Klik butang Get New Access Token untuk mendapatkan token anda dan simpan.
  16. Untuk semua panggilan API di bawah koleksi Wink API, pastikan tab pengesahan mengatakan Inherit auth from parent supaya token anda disertakan dengan setiap panggilan.