Setup

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

Pengujian harus selalu dilakukan dilingkungan pementasanData di sana jauh lebih sedikit, tetapi Anda bebas menguji sebanyak yang Anda inginkan tanpa mengganggu lingkungan produksi.

Setelah Anda siap untuk memulai, kami akan mensertifikasi akun dan aplikasi Anda dan Anda dapat meluncurkannya di lingkungan produksi kami.

Ikuti langkah-langkah berikut:

1. Daftar akun pengguna Anda di Wink
2. Membuat sebuah akun agen perjalanan atau sebuah akun afiliasi.
3. Membuat Aplikasi di mana Anda mengaitkannya dengan akun yang Anda buat pada Langkah 2.
4. Setelah Anda membuat Application, simpan id klien dan rahasia klien di tempat yang aman.

Bahasa Inggris

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.

Kita cloud_name adalah traveliko.

Berawan

• Memulai
• SDK (Software Development Kit)
• Cloudinary di GitHub
• Tutorial Video

Contoh

Untuk setiap jenis inventaris perjalanan yang kami dukung, akan ada array JSON bersarang yang disebutmultimediasJSON 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": "Picture of the lobby",
      "language": "en"
    }
  ],
  "lifestyleType": "LIFESTYLE_BUSINESS",
  "attribution": [
    {
      "url": "https://www.hilton.com",
      "name": "Hilton"
    }
  ]
}

Garis yang disorot di atas menunjukkan ID unik Cloudinarypartners/radisson_blu_logoHanya itu yang Anda butuhkan untuk mengambil gambar dalam format, kualitas, dan ukuran apa pun yang Anda inginkan.

Pengujian

Kunjungi situs kamiLebahbagian dan pilih API yang ingin Anda gunakan.

Dokumen API

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

Dalam contoh ini, Anda ingin menggunakanSearch Lookups (OAuth2)Panggilan API.

:::tip[Tips Pro] Untuk kemudahan penggunaan, kami sarankan integrator menggunakan titik akhir yang kami tetapkan sebagaiOAuth2Titik akhir tersebut mengetahui untuk mengharapkan pemanggil API dan sudah mengetahui akun mana yang Anda gunakan sehingga Anda tidak perlu menentukancompanyIdentifierdi URL Anda. :::

1. Gunakan Pencarian API untuk mengambil tujuan atau hotel.
2. Di navbar kiri, klik Authentication.
3. Masukkan id klien dan rahasia klien Anda dan klik Get TOKEN tombol.
4. Jika kredensial Anda valid, Anda akan melihat bahwa kunci API Anda telah diterapkan.
5. Anda sekarang dapat menguji titik akhir pencarian.

Pencarian Sampel (OAuth2)

Tukang pos

Anda dapat melakukan hal yang sama dengan Postman.

1. Unduh Tukang pos.
2. Klik di sini Download OpenAPI spec dari atas Pencarian API halaman.
3. Impor ke Postman.
4. Jika Anda mengimpornya sebagai koleksi baru yang disebut Wink API, klik elipsis horizontal (3 titik) di sebelah nama koleksi dan klik Edit.
5. Di dalam Authorization tab, mengatur Auth type ke OAuth2.
6. Mengatur lapangan Add auth data to ke Request headers.
7. Mengatur lapangan Header prefix ke Bearer.
8. Mengatur lapangan Token Name sesuai nama yang Anda inginkan untuk token yang Anda simpan di Postman. Misalnya Wink Staging.
9. Mengatur lapangan Grant type ke Client Credentials.
10. Mengatur lapangan Access token URL ke https://staging-iam.wink.travel/oauth2/token.
11. Mengatur lapangan Client ID ke ID Klien yang membantu pembuatan aplikasi Anda.
12. Mengatur lapangan Client Secret ke Rahasia Klien yang membantu dibuat oleh aplikasi Anda.
13. Mengatur lapangan Scope ke inventory.read inventory.write inventory.removeItu semua adalah cakupan yang Anda perlukan untuk Wink.
14. Mengatur lapangan Client Authentication ke Send as Basic Auth header.
15. Klik tombol Get New Access Token untuk mengambil token Anda dan menyimpannya.
16. Untuk semua panggilan API di bawah koleksi API Wink, pastikan tab autentikasi mengatakan Inherit auth from parent jadi itu menyertakan token Anda dengan setiap panggilan.

:::tip[Tips Pro] Disarankan untuk menjadikan domain server, ID klien, dan rahasia klien sebagai variabel lingkungan. Dengan begitu, Anda dapat dengan mudah beralih antara lingkungan staging dan produksi serta menggunakan kembali semua operasi yang telah Anda buat. :::