Skip to main content

​
Kredit dan Batas Laju

Hingga 100.000 alamat menggunakan API.
Ya, mengedit webhook melalui API atau dasbor dikenai biaya 100 kredit per permintaan. Ini berlaku untuk setiap perubahan, termasuk mengubah URL, menambahkan/menghapus alamat, atau memperbarui jenis transaksi.
Setiap peristiwa webhook dikenai biaya 1 kredit saat Helius memproses dan mengirimkan peristiwa tersebut ke endpoint Anda. Anda tetap dikenai biaya terlepas dari apakah endpoint Anda berhasil memproses webhook atau mengembalikan kesalahan.
Semua operasi pengelolaan webhook (membuat, mengedit, menghapus) dikenai biaya 100 kredit per permintaan jika dilakukan melalui API. Biaya ini mencakup pemrosesan yang diperlukan untuk memperbarui konfigurasi webhook Anda.

​
Jaringan yang Didukung

Ya. Jika Anda membuat webhook melalui UI, pilih “devnet” sebagai “Jaringan”. Jika Anda membuatnya melalui Webhook API, tetapkan parameter “webhookType” ke “rawDevnet”, “enhancedDevnet”, atau “discordDevnet” sesuai dengan jenis webhook yang Anda inginkan.
Tidak—URL harus dapat diakses secara publik melalui HTTPS. Helius tidak dapat mengakses server pengembangan lokal melalui URL localhost.

​
Menggunakan Webhook

Tetapkan header otorisasi saat membuat atau memperbarui webhook. Helius mengirimkan kembali nilai ini dalam header Authorization saat mengirim data ke endpoint webhook Anda, sehingga Anda dapat memverifikasi keaslian permintaan tersebut.
Webhook mentah mengembalikan data transaksi Solana biasa langsung dari blockchain. Saat transaksi terjadi untuk alamat yang dipantau, data transaksi mentah dikirim ke URL webhook Anda.Webhook yang diperkaya menyediakan jenis transaksi yang telah ditafsirkan oleh Helius. Kami mengurai lebih dari 100 jenis transaksi Solana (listing NFT, swap DeFi, transfer, dan sebagainya) dan mengabstraksikannya ke dalam skema kami sendiri.Gunakan webhook mentah jika Anda menginginkan semua data transaksi tanpa abstraksi, atau webhook yang diperkaya jika Anda menginginkan deteksi dan penguraian jenis transaksi bawaan.
Webhook mengirimkan notifikasi segera setelah transaksi yang cocok dikonfirmasi di blockchain.

​
Percobaan Ulang

Endpoint Anda harus mengembalikan kode status 200 dalam waktu 1 detik untuk mengonfirmasi bahwa peristiwa berhasil diterima. Sebagai praktik terbaik, segera berikan respons 200 dan tangani pemrosesan secara asinkron — ini mencegah waktu habis yang disebabkan oleh logika bisnis yang lambat.
Helius mencoba kembali pengiriman saat endpoint Anda mengembalikan kesalahan 5xx, kesalahan 4xx (kecuali 403), mengalami waktu habis, atau gagal akibat kesalahan koneksi maupun kegagalan DNS. Kami mencoba kembali hingga 3 kali dengan jeda 1 detik di antara setiap percobaan.Jika semua percobaan ulang gagal, peristiwa tersebut hilang secara permanen — tidak ada antrean ulang atau siklus pengiriman kedua.Pantau log webhook Anda di Dasbor Helius untuk mengidentifikasi kegagalan pengiriman dan menyelidiki masalah endpoint.Kami juga menawarkan kebijakan percobaan ulang yang dapat disesuaikan untuk paket perusahaan.
Helius dapat mengirimkan peristiwa webhook yang sama beberapa kali. Hal ini dapat terjadi akibat logika percobaan ulang atau masalah jaringan.Penangan webhook Anda harus siap menangani duplikat dengan baik — memproses peristiwa yang sama beberapa kali harus menghasilkan keluaran yang sama seperti memprosesnya sekali.Untuk menangani duplikat, gunakan tanda tangan transaksi atau pengidentifikasi peristiwa unik guna melacak peristiwa yang telah Anda proses.
Tergantung pada jenis webhook. Webhook yang diperkaya tidak mengirimkan transaksi yang gagal, tetapi webhook mentah menyertakan transaksi yang berhasil maupun gagal.

​
Penonaktifan Otomatis

Helius memantau kondisi endpoint dan secara otomatis menonaktifkan webhook dengan tingkat kegagalan pengiriman ≥ 95%. Paket berbayar (Dev dan yang lebih tinggi) dievaluasi dalam rentang waktu 7 hari, sedangkan webhook paket Gratis dievaluasi dalam rentang waktu 24 jam. Hal ini mencegah percobaan pengiriman yang sia-sia ke endpoint yang tidak dapat dijangkau.Penyebab umum meliputi URL endpoint yang tidak dapat dijangkau, server Anda yang terus-menerus mengembalikan respons kesalahan, atau masalah jaringan/firewall yang memblokir pengiriman Helius.
  1. Perbaiki masalah yang mendasari pada endpoint Anda.
  2. Masuk ke Dasbor Helius.
  3. Temukan webhook yang dinonaktifkan dan aktifkan kembali.
Anda juga dapat mengaktifkan kembali webhook secara terprogram melalui endpoint Toggle Webhook API dengan mengirimkan permintaan PATCH berisi { "active": true }.
Tidak. Setelah diaktifkan kembali, webhook memasuki masa tenggang 24 jam dan tidak akan dinonaktifkan secara otomatis selama periode tersebut. Ini memberi Anda waktu untuk memastikan endpoint Anda berfungsi dengan baik sebelum evaluasi berikutnya.
Ya — pengguna paket Dev dan yang lebih tinggi menerima notifikasi email saat webhook dinonaktifkan secara otomatis. Pengguna paket Gratis dapat memantau status webhook di Dasbor Helius.
Ya. Anda dapat mengaktifkan dan menonaktifkan webhook dari Dasbor Helius atau melalui endpoint Toggle Webhook API. Dengan demikian, Anda dapat menjeda pengiriman untuk sementara tanpa kehilangan konfigurasi webhook.

​
Memecahkan Masalah Webhook

Hilangnya data biasanya terjadi saat endpoint Anda mengalami kesalahan, sehingga memicu percobaan ulang webhook yang akhirnya gagal dan menyebabkan kehilangan data. Periksa log webhook Anda di dasbor, pastikan pencatatan log sisi klien yang memadai telah diterapkan, dan hubungi dukungan jika masalah berlanjut.
Pastikan jenis transaksi yang dipilih cocok dengan transaksi yang Anda pantau. Mulailah dengan jenis transaksi “ANY” untuk menentukan apakah masalahnya bersifat umum atau disebabkan oleh ketidakcocokan jenis. Gunakan webhook.site untuk menguji apakah masalahnya terletak pada konfigurasi endpoint Anda.
Webhook TOKEN_MINT hanya dipicu untuk program tertentu seperti Candy Machine V1 dan Solana Program Library. Webhook ini tidak mencakup semua peristiwa pencetakan token di seluruh blockchain. Untuk pemantauan yang lebih luas, pertimbangkan penggunaan langganan akun atau program yang lebih umum melalui webhook dengan pemfilteran jenis transaksi “ANY”.

​
Perlu Bantuan Lebih Lanjut?

Contact Support

Dapatkan bantuan dari tim kami melalui Discord, obrolan, atau dukungan email.

Status Page

Periksa ketersediaan layanan dan informasi performa secara real-time.