Apa itu webhook Solana?
Webhook Solana adalah notifikasi HTTP real-time yang dikirim ke aplikasi Anda saat terjadi peristiwa on-chain. Alih-alih terus melakukan polling pada blockchain, Helius mengirimkan data transaksi yang telah diuraikan langsung ke endpoint Anda setiap kali dompet mentransfer dana, NFT terjual, atau jenis transaksi yang dipantau dipicu. Gunakan webhook untuk mendukung bot perdagangan, dasbor analitik, pipeline kepatuhan, dan otomatisasi berbasis peristiwa. Kami menyediakan antarmuka yang mudah digunakan serta akses melalui API dan SDK untuk memudahkan pembuatan dan pengelolaan webhook. Untuk pertanyaan umum, lihat FAQ Webhook. Untuk proyek baru yang memerlukan transaksi terurai secara real-time, pertimbangkan Parsed Streams. Fitur ini menggantikan Enhanced Transaction Webhooks, mendekode setiap instruksi melalui katalog IDL, melakukan pemfilteran di sisi server berdasarkan program, akun, dan nama instruksi, serta dikenai biaya yang sama sebesar 1 kredit per peristiwa pada semua paket.Harga
Peristiwa webhook dikenai biaya 1 kredit saat Helius memproses dan mengirimkan peristiwa tersebut ke endpoint Anda. Biaya tetap dikenakan terlepas dari apakah endpoint Anda berhasil memproses webhook atau tidak. Mengedit, menambahkan, atau menghapus webhook melalui API akan dikenai biaya 100 kredit/permintaan.Jenis Webhook
Saat ini, kami menyediakan beberapa jenis webhook yang disesuaikan dengan berbagai kebutuhan:Webhook Transaksi yang Disempurnakan
Menyediakan data terurai yang mudah dibaca untuk jenis transaksi tertentu (misalnya, penjualan NFT) yang terkait dengan alamat yang Anda pantau. Opsi ini ideal jika Anda menginginkan informasi terfilter yang dapat langsung ditindaklanjuti.Webhook Transaksi Mentah
Opsi ini mengirimkan data transaksi mentah untuk semua transaksi yang melibatkan alamat yang Anda pantau. Opsi ini tidak mendukung pemfilteran berdasarkan jenis transaksi.Webhook Transaksi Mentah menawarkan latensi lebih rendah karena tidak melibatkan penguraian jenis peristiwa.
Webhook Discord
Alirkan pembaruan untuk jenis transaksi tertentu langsung ke kanal Discord yang ditentukan sebagai pesan terformat. Untuk menggunakan opsi ini, Anda harus mengirimkan URL Webhook Discord Anda.Contoh Payload Peristiwa
Enhanced
Enhanced
Raw
Raw
Mulai
Webhooks Quickstart
Buat webhook pertama Anda melalui Dasbor, REST API, atau SDK TypeScript/Rust resmi.
Penonaktifan Otomatis Webhook yang Gagal
Helius memantau kondisi endpoint webhook dan secara otomatis menonaktifkan webhook yang terus-menerus gagal menerima pengiriman. Hal ini mencegah percobaan pengiriman yang sia-sia ke endpoint yang tidak dapat dijangkau atau bermasalah.Cara Kerjanya
- Paket berbayar (Dev dan yang lebih tinggi): Webhook dengan tingkat kegagalan ≥ 95% selama 7 hari akan dinonaktifkan secara otomatis.
- Paket Gratis: Webhook dievaluasi dalam periode 24 jam dengan ambang batas kegagalan yang sama.
Notifikasi Email
Pengguna paket Dev dan yang lebih tinggi menerima notifikasi email saat webhook dinonaktifkan secara otomatis.Mengaktifkan Kembali Webhook yang Dinonaktifkan
1
Fix your endpoint
Atasi masalah yang menyebabkan kegagalan pengiriman (misalnya, server tidak aktif, URL salah, atau kesalahan endpoint).
2
Log in to the Helius Dashboard
Buka Dasbor Helius.
3
Re-enable the webhook
Temukan webhook yang dinonaktifkan, lalu aktifkan kembali.
Setelah diaktifkan kembali, webhook memasuki masa tenggang 24 jam. Selama periode ini, webhook tidak akan dinonaktifkan kembali secara otomatis. Ini memberi Anda waktu untuk memastikan bahwa endpoint Anda berfungsi dengan baik.
Contoh Penggunaan
Bot
- Saat NFT dicantumkan di marketplace X, picu tindakan “beli NFT”.
- Saat posisi margin tidak sehat, picu tindakan “likuidasi”.
Pemantauan & Peringatan
- Saat program menghasilkan log tertentu, picu integrasi PagerDuty.
- Saat saldo akun token berubah lebih dari X%, gunakan Dialect untuk mengirimkan peringatan.
Pengindeksan Berbasis Peristiwa
- Saat transaksi apa pun terjadi pada program tertentu, kirimkan transaksi tersebut langsung ke basis data atau backend Anda.
Notifikasi & Pelacakan Aktivitas
- Saat terjadi transfer dari dompet X ke dompet Y — kirim notifikasi Slack atau email.
Analitik & Log
- Saat peristiwa X terjadi, kirimkan ke pipeline ETL atau simpan langsung di Helius untuk melihat tren dari waktu ke waktu.
Otomatisasi Alur Kerja
- Saat peristiwa X terjadi, picu serangkaian tindakan apa pun.