Partner API

Wink Partner API adalah cara terautentikasi dengan throughput lebih tinggi bagi integrator untuk menanyakan inventaris perjalanan yang dapat dipesan — pasokan yang sama yang mendukung widget yang dapat disematkan dan endpoint penelusuran publik kami, yang disajikan sebagai antarmuka programatik kelas satu. Di mana Web Components gratis dan endpoint penelusuran publik ditujukan untuk penyematan ringan yang berorientasi pada pengguna, Partner API dibangun untuk sistem yang mencari, memberi harga, dan memesan dalam skala besar. Akses diautentikasi per integrator dan ditagih berdasarkan penggunaan, sehingga Anda hanya membayar untuk lalu lintas yang benar-benar Anda kirim.

Paket & harga

Penggunaan diukur dalam hotel-malam: satu hotel yang dihargai untuk satu malam menginap — bukan satu panggilan API. Pencarian yang mengembalikan 20 hotel untuk masa inap 3 malam adalah 60 hotel-malam dari satu permintaan. Panggilan Konten dan Lookup (pencarian tujuan dan autocomplete) adalah pengecualian: masing-masing dikenakan biaya satu unit per panggilan, apa pun yang dikembalikan. Endpoint akun gratis. Harga adalah sumber kebenaran untuk tarif.

	Gratis	Berbayar	Enterprise
Harga	$0	Berdasarkan penggunaan	Hubungi kami
Terbaik untuk	Evaluasi & integrasi volume rendah	Throughput bayar sesuai penggunaan dalam skala besar	Volume khusus & ketentuan negosiasi
Unit per bulan	10.000	Tak terbatas	Tak terbatas
Waktu respons API (P95)	—	Di bawah 500 ms	Di bawah 500 ms
Harga per unit (hotel-malam)	Gratis	$0,0001	Khusus
Respons saat kuota bulanan habis	429 sampai tanggal 1 bulan berikutnya (UTC)	Ditagih, tidak diblokir	Sesuai kesepakatan
Perjanjian Tingkat Layanan	—	✓	✓
Dukungan prioritas	—	✓	✓
Onboarding khusus	—	—	✓

Dapatkan kunci API · Mulai penagihan meteran · Hubungi penjualan

Referensi API

Dua permukaan melayani inventaris yang dapat dipesan, dan keduanya sesuai dengan dua tingkatan di atas:

Gratis — Consumer / Booking Engine API (REST, /api/public/**): anonim, berorientasi browser dan widget. Jelajahi referensi Booking Engine →
Berbayar — Partner Integrator API (gRPC, wink.partner.v1): terautentikasi, penggunaan diukur, dibangun untuk integrasi server-ke-server dalam skala besar. Jelajahi referensi Integrator →

Partner Integrator API adalah gRPC, bukan REST. Anda memanggilnya dengan klien yang dihasilkan melalui HTTP/2 di partner.wink.travel:443, melewatkan token bearer dan akun yang Anda panggil:

grpcurl -H "authorization: Bearer $WINK_TOKEN" partner.wink.travel:443 list

Halaman referensi di atas mendokumentasikan setiap layanan, pesan, dan status kesalahan, dan skema juga tersedia pada runtime melalui refleksi server, sehingga grpcurl, Postman, dan Insomnia dapat menemukannya tanpa perlu mengunduh apa pun.

Jika Anda lebih suka menghasilkan klien terlebih dahulu, file sumber .proto diterbitkan di github.com/wink-travel/partner-api-proto.

Cara kerja penggunaan dan batasan

Tingkat gratis

Tingkat Gratis dirancang untuk memungkinkan Anda membangun, menguji, dan menjalankan lalu lintas produksi yang sederhana tanpa biaya.

Tidak ada batas per menit yang dipublikasikan. Wink memantau tingkat permintaan dan dapat menerapkan batas penggunaan wajar untuk melindungi layanan. Jika Anda menerima HTTP 429 (Terlalu Banyak Permintaan), tunggu selama jumlah detik yang tercantum di header Retry-After sebelum mencoba lagi.
Kuota bulanan — 10.000 unit per bulan kalender. Kuota diberikan per akun dan direset pada tanggal 1 setiap bulan (UTC). Setelah mencapai kuota, akun yang belum mendaftar penagihan bayar sesuai penggunaan akan menerima HTTP 429 sampai tanggal 1 bulan berikutnya — penghentian keras, dengan header Retry-After dan pesan yang mengundang Anda untuk berlangganan tingkat Berbayar. Akun yang terdaftar tetap berfungsi dan ditagih untuk penggunaan di luar kuota.

Tingkat Gratis tidak termasuk Perjanjian Tingkat Layanan atau dukungan prioritas.

Tingkat berbayar

Tingkat Berbayar menghapus batas bulanan dan hanya menagih Anda untuk apa yang Anda gunakan.

Hotel-malam yang diukur — $0,0001 per hotel-malam. Tidak ada batas bulanan; Anda ditagih berdasarkan volume aktual. Wink mungkin masih menerapkan batas penggunaan wajar untuk melindungi layanan. Panggilan pencarian dan inventaris ditagih per hotel-malam yang dihargai; panggilan Konten dan Lookup ditagih satu unit masing-masing, jadi penggabungan permintaan Anda menjaga tagihan tetap rendah.

Tingkat Berbayar mencakup Perjanjian Tingkat Layanan yang dijelaskan di bawah — komitmen uptime 99,9% dan target waktu respons P95 di bawah 500 ms — serta dukungan prioritas berbasis tingkat keparahan.

Perjanjian Tingkat Layanan

Tanggal berlaku: 5 Juli 2026 · Versi 1.0

Perjanjian Tingkat Layanan ini (“SLA”) menetapkan komitmen ketersediaan, kredit layanan, dan target dukungan yang diberikan Wink (“Wink”, “kami”, “kita”) kepada pelanggan (“Pelanggan”, “Anda”) untuk Partner API Wink yang terautentikasi (“Partner API” atau “Layanan”) pada tingkatan di mana SLA dinyatakan berlaku. SLA ini menjadi bagian dari dan diatur oleh perjanjian antara Anda dan Wink di mana Anda mengakses Partner API (“Perjanjian”), dan berlaku selama Anda mempertahankan langganan Partner API berbayar yang aktif dan dalam kondisi baik. Istilah yang diawali huruf kapital yang tidak didefinisikan di sini memiliki arti sebagaimana diberikan dalam Perjanjian.

1. Definisi

“Uptime” berarti periode di mana Partner API tersedia untuk menerima dan berhasil merespons permintaan yang dibentuk dengan benar dan terautentikasi.
“Downtime” berarti periode apa pun, diukur dalam menit, di mana Partner API gagal merespons dengan sukses permintaan yang dibentuk dengan benar dan terautentikasi, tidak termasuk periode yang termasuk dalam Pengecualian yang diatur dalam Bagian 4. Kesalahan terisolasi yang memengaruhi sebagian kecil permintaan tidak dianggap sebagai Downtime.
“Persentase Uptime Bulanan” berarti, untuk bulan kalender tertentu, jumlah total menit dalam bulan tersebut dikurangi total menit Downtime, dibagi dengan jumlah total menit dalam bulan tersebut, dinyatakan dalam persentase.
“Pemeliharaan Terjadwal” berarti pemeliharaan layanan yang direncanakan di mana Wink telah memberikan pemberitahuan sebelumnya sesuai dengan Bagian 4.
“Kredit Layanan” berarti kredit, yang dihitung sebagai persentase dari biaya yang dibayar atau harus dibayar oleh Anda untuk Partner API pada bulan kalender yang terkena dampak, yang diterapkan terhadap biaya Partner API di masa depan sebagai satu-satunya dan eksklusif solusi atas kegagalan memenuhi Komitmen Uptime.
“Waktu Respons” berarti waktu yang berlalu antara penerimaan permintaan yang dibentuk dengan benar dan terautentikasi di batas layanan Wink dan titik di mana Wink mulai mengembalikan respons, tidak termasuk waktu transit jaringan dan waktu sisi klien di luar kendali Wink.

2. Komitmen Ketersediaan & Kinerja

Wink akan menggunakan upaya yang wajar secara komersial untuk membuat Partner API tersedia dengan Persentase Uptime Bulanan minimal 99,9% selama setiap bulan kalender masa berlaku (disebut “Komitmen Uptime”). Komitmen Uptime diukur di batas layanan Wink dan tidak termasuk faktor di luar kendali wajar Wink, termasuk yang dijelaskan dalam Bagian 4. Sistem pemantauan Wink adalah sumber otoritatif untuk mengukur Persentase Uptime Bulanan dan Waktu Respons.

Wink juga menargetkan Waktu Respons persentil ke-95 (P95) di bawah 500 milidetik untuk permintaan yang berhasil, dibentuk dengan benar, dan terautentikasi, diukur di batas layanan Wink selama setiap bulan kalender (disebut “Target Kinerja”). Target Kinerja tidak termasuk faktor yang dijelaskan dalam Bagian 4, permintaan yang mengembalikan kesalahan tingkat aplikasi yang disebabkan oleh permintaan itu sendiri, dan permintaan batch yang sangat besar atau kompleks. Target Kinerja adalah tujuan layanan; Kredit Layanan dalam Bagian 3 berlaku untuk kegagalan memenuhi Komitmen Uptime dan merupakan satu-satunya dan eksklusif solusi atas kekurangan ketersediaan.

3. Kredit Layanan

Jika Persentase Uptime Bulanan turun di bawah Komitmen Uptime dalam bulan kalender apa pun, Anda mungkin berhak atas Kredit Layanan yang dihitung sebagai persentase dari biaya Partner API yang dibayar atau harus dibayar oleh Anda untuk bulan tersebut, sesuai tangga berikut:

Persentase Uptime Bulanan	Kredit Layanan
Di bawah 99,9% tapi di atas atau sama dengan 99,0%	10%
Di bawah 99,0% tapi di atas atau sama dengan 95,0%	25%
Di bawah 95,0%	50%

Mengajukan klaim kredit. Untuk menerima Kredit Layanan Anda harus mengajukan klaim tertulis kepada Wink dalam waktu tiga puluh (30) hari setelah akhir bulan kalender di mana kekurangan terjadi. Klaim harus mencantumkan tanggal dan waktu setiap insiden Downtime yang Anda klaim serta log atau bukti pendukung yang wajar tersedia bagi Anda. Klaim yang diajukan setelah jangka waktu ini tidak memenuhi syarat.
Bentuk kredit. Kredit Layanan yang disetujui diterapkan terhadap biaya Partner API di masa depan dan tidak memiliki nilai tunai. Kredit ini bukan pengembalian dana dan tidak akan dibayarkan kecuali diwajibkan oleh hukum yang berlaku.
Kredit maksimum. Total Kredit Layanan yang diberikan untuk satu bulan kalender tidak akan melebihi 50% dari biaya Partner API yang dibayar atau harus dibayar oleh Anda untuk bulan tersebut.
Solusi tunggal dan eksklusif. Kredit Layanan adalah solusi tunggal dan eksklusif Anda atas kegagalan Wink memenuhi Komitmen Uptime atau kekurangan ketersediaan Partner API lainnya.

4. Pengecualian

Komitmen Uptime dan Kredit Layanan yang dihasilkan tidak berlaku, dan Downtime tidak termasuk, ketidaktersediaan, penangguhan, degradasi, atau masalah kinerja yang timbul dari atau terkait dengan:

Pemeliharaan Terjadwal yang telah diberitahukan sebelumnya oleh Wink, dengan catatan pemberitahuan tersebut diberikan dalam jangka waktu yang wajar melalui saluran yang biasa digunakan Wink untuk berkomunikasi dengan pelanggan;
kejadian force majeure atau penyebab lain di luar kendali wajar Wink, termasuk bencana alam, tindakan pemerintah, kegagalan jaringan atau utilitas, dan serangan denial-of-service atau serangan jahat lainnya;
masalah yang disebabkan oleh tindakan atau kelalaian Anda, peralatan, perangkat lunak, atau jaringan Anda, atau oleh layanan, produk, atau penyedia pihak ketiga yang tidak berada di bawah kendali langsung Wink;
penyalahgunaan Layanan oleh Anda atau pelanggaran Perjanjian, SLA ini, ketentuan penggunaan yang dapat diterima, atau batas tarif yang berlaku, termasuk lalu lintas yang secara wajar dianggap Wink berlebihan, penyalahgunaan otomatis, atau penipuan; dan
setiap penangguhan atau penghentian akses Anda yang dilakukan dengan benar berdasarkan Perjanjian, termasuk penangguhan karena tidak membayar.

5. Dukungan & Target Respons

Wink menyediakan dukungan untuk Partner API selama jam kerja standar, tidak termasuk hari libur lokal. Wink akan menggunakan upaya yang wajar secara komersial untuk mengakui permintaan dukungan yang diajukan dengan benar dalam waktu respons target berikut, berdasarkan tingkat keparahan yang Anda tetapkan dan yang secara wajar dikonfirmasi oleh Wink:

Tingkat Keparahan	Deskripsi	Target respons awal
Sev 1 — Kritis	Partner API tidak berfungsi atau tidak dapat digunakan di produksi tanpa solusi sementara.	4 jam
Sev 2 — Mayor	Fitur penting terganggu atau menurun; ada solusi sementara.	1 hari kerja
Sev 3 — Minor	Pertanyaan umum, masalah kecil, atau permintaan fitur.	2 hari kerja

Waktu respons target menggambarkan kapan Wink bertujuan melakukan kontak awal; ini bukan jaminan waktu penyelesaian. Dukungan prioritas dan target berbasis tingkat keparahan berlaku pada tingkatan di mana hal tersebut dinyatakan termasuk.

6. Data & Keamanan

Wink mempertahankan langkah administratif, teknis, dan organisasi yang wajar secara komersial yang dirancang untuk melindungi kerahasiaan, integritas, dan ketersediaan data yang diproses melalui Partner API, dan meninjau langkah-langkah tersebut secara berkala. Pemrosesan data pribadi oleh Wink diatur oleh Kebijakan Privasi dan ketentuan pemrosesan data dalam Perjanjian. Anda tetap bertanggung jawab untuk mengamankan kredensial API Anda sendiri, untuk penggunaan data yang sah dari data yang Anda ambil, dan untuk segera memberi tahu Wink jika ada dugaan kompromi kredensial.

7. Batasan Tanggung Jawab

Kredit Layanan adalah solusi tunggal dan eksklusif atas ketidaktersediaan atau kegagalan memenuhi Komitmen Uptime, dan diberikan sebagai pengganti tanggung jawab lain yang timbul dari kegagalan tersebut. Kecuali secara tegas dinyatakan dalam SLA ini, Partner API disediakan “sebagaimana adanya”. Sejauh diizinkan oleh hukum yang berlaku, tanggung jawab agregat Wink yang timbul dari atau terkait dengan Layanan dibatasi sebagaimana diatur dalam Perjanjian, dan Wink tidak bertanggung jawab atas kerusakan tidak langsung, insidental, khusus, konsekuensial, atau hukuman, atau atas kehilangan keuntungan, pendapatan, data, atau reputasi, bahkan jika telah diberitahu tentang kemungkinan kerusakan tersebut.

8. Masa Berlaku, Perubahan & Penghentian

SLA ini berlaku selama Anda memiliki langganan Partner API aktif pada tingkatan di mana SLA dinyatakan berlaku. Wink dapat memperbarui SLA ini dari waktu ke waktu; perubahan material akan dikomunikasikan melalui saluran yang biasa digunakan Wink untuk menjangkau pelanggan, dan penggunaan Partner API yang berkelanjutan setelah pembaruan berlaku berarti Anda menerima SLA yang diperbarui. SLA ini berakhir secara otomatis setelah penghentian atau berakhirnya Perjanjian atau langganan Partner API Anda. Bagian-bagian yang secara alami harus bertahan setelah penghentian — termasuk kelayakan Kredit Layanan yang belum diklaim, batasan tanggung jawab, dan definisi — tetap berlaku.