Lewati ke konten
Wink

Pengaturan

Artikel ini menunjukkan cara cepat menyiapkan sebagai pengembang dan mulai menguji API kami di Wink.

Ikuti langkah-langkah berikut:

  1. Daftar akun pengguna Anda di Wink.
  2. Buat akun afiliasi. Anda memerlukan ini untuk mengikat Aplikasi Anda. Lihat apa itu Studio untuk konteks lebih lanjut.
  3. Buat Aplikasi dan kaitkan dengan akun afiliasi yang Anda buat di Langkah 2. Untuk integrasi API server-ke-server, pilih MACHINE_2_MACHINE sebagai tipe klien.
  4. Setelah Anda membuat Application, salin dan simpan client-id dan secret key segera — secret key hanya ditampilkan sekali dan tidak dapat diambil kembali.

CDN

Section titled “CDN”

Di Wink, kami menggunakan Cloudinary untuk semua aset gambar dan video kami. Saat Anda mengakses inventaris perjalanan kami, Anda akan memiliki akses penuh ke semua fitur canggih Cloudinary.

cloud_name kami adalah traveliko.

Cloudinary

Section titled “Cloudinary”

Contoh

Section titled “Contoh”

Untuk setiap jenis inventaris perjalanan yang kami dukung, akan ada array JSON bersarang bernama multimedias. JSON untuk entri multimedia terlihat 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 disorot di atas menunjukkan ID unik Cloudinary partners/radisson_blu_logo. Itu saja yang Anda butuhkan untuk mengambil gambar dalam format, kualitas, dan ukuran apa pun yang Anda inginkan.

Pengujian

Section titled “Pengujian”

Langsung saja ke bagian API kami dan pilih API yang ingin Anda gunakan.

Dokumen API

Section titled “Dokumen API”

Situs dokumentasi kami disusun sedemikian rupa sehingga Anda dapat menjalankan perintah API langsung dari dalam situs.

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

  1. Gunakan Lookup API untuk mengambil destinasi atau hotel.
  2. Di navbar kiri, klik Authentication.
  3. Masukkan client-id dan client secret Anda lalu klik tombol Get TOKEN.
  4. Jika kredensial Anda valid, Anda akan melihat bahwa kunci API Anda telah diterapkan.
  5. Sekarang Anda dapat menguji endpoint lookup.
Endpoint API Lookup
Contoh Search Lookups (OAuth2)

Postman

Section titled “Postman”

Anda dapat melakukan hal yang sama dengan Postman.

  1. Unduh Postman.
  2. Klik Download OpenAPI spec dari bagian atas halaman Lookup API.
  3. Impor ke Postman.
  4. Jika Anda mengimpornya sebagai koleksi baru bernama Wink API, klik elipsis horizontal (3 titik) di samping nama koleksi dan klik Edit.
  5. Di tab Authorization, atur Auth type ke OAuth2.
  6. Atur bidang Add auth data to ke Request headers.
  7. Atur bidang Header prefix ke Bearer.
  8. Atur bidang Token Name ke nama apa pun yang Anda inginkan untuk token yang disimpan di Postman. Misalnya Wink Staging.
  9. Atur bidang Grant type ke Client Credentials.
  10. Atur bidang Access token URL ke https://staging-iam.wink.travel/oauth2/token.
  11. Atur bidang Client ID ke Client ID yang dihasilkan aplikasi Anda.
  12. Atur bidang Client Secret ke Client Secret yang dihasilkan aplikasi Anda.
  13. Atur bidang Scope ke inventory.read inventory.write inventory.remove. Itu semua scope yang Anda perlukan untuk Wink.
  14. Atur bidang Client Authentication ke Send as Basic Auth header.
  15. Klik tombol Get New Access Token untuk mengambil token Anda dan simpan.
  16. Untuk semua panggilan API di bawah koleksi Wink API, pastikan tab otentikasi mengatakan Inherit auth from parent agar token Anda disertakan di setiap panggilan.