Skip to main content

​
Artinya

401 Tidak Diotorisasi - Permintaan Anda tidak memiliki kredensial autentikasi yang valid.

​
Penyebab umum

  • Kunci API tidak valid atau tidak ada
  • Kunci API disertakan di lokasi yang salah
  • Aturan Kontrol Akses memblokir permintaan Anda
  • Kunci API telah kedaluwarsa atau dicabut

​
Solusi

  1. Verifikasi format kunci API Anda
  2. Periksa penempatan kunci API
    • Pastikan kunci API berada dalam parameter kueri
    • Pastikan tidak ada spasi atau karakter tambahan
  3. Tinjau Aturan Kontrol Akses
    • Periksa pengaturan dasbor Anda untuk pembatasan IP
    • Pastikan domain Anda telah dimasukkan ke daftar yang diizinkan jika menggunakan permintaan browser
Untuk penyiapan autentikasi secara mendetail, lihat panduan Autentikasi kami.

​
Artinya

429 Terlalu Banyak Permintaan - Anda telah melampaui batas laju paket Anda.

​
Penyebab umum

  • Mengirim permintaan lebih cepat daripada yang diizinkan paket Anda
  • Lonjakan lalu lintas melampaui batas sesaat
  • Beberapa aplikasi menggunakan kunci API yang sama
  • Kode yang tidak efisien mengirim permintaan berulang yang tidak diperlukan

​
Solusi

  1. Pantau penggunaan Anda
    • Periksa grafik Rate Limited Requests di dasbor Anda
    • Tinjau endpoint mana yang mencapai batas
  2. Optimalkan permintaan Anda
    • Simpan respons dalam cache jika memungkinkan
    • Gabungkan beberapa operasi ke dalam satu panggilan
    • Hapus polling yang tidak diperlukan atau permintaan duplikat
  3. Terapkan pembatasan laju
    • Tambahkan jeda antarpermintaan dalam aplikasi Anda
    • Gunakan backoff eksponensial untuk percobaan ulang
  4. Pertimbangkan untuk meningkatkan paket
Batas laju diatur ulang setiap menit, sehingga pembatasan sementara biasanya cepat teratasi.

​
Artinya

500 Kesalahan Server Internal - Terjadi kesalahan di sisi server saat memproses permintaan Anda.

​
Penyebab umum

  • Payload permintaan salah format
  • Server mengalami masalah sementara
  • Parameter tidak valid menyebabkan kesalahan server
  • Masalah konektivitas jaringan

​
Solusi

  1. Validasi permintaan Anda
    • Pastikan payload JSON diformat dengan benar
    • Pastikan semua parameter wajib telah disertakan
    • Pastikan tipe parameter sesuai dengan spesifikasi API
  2. Periksa status layanan
    • Kunjungi Halaman Status Helius untuk melihat masalah yang sedang berlangsung
    • Cari laporan gangguan atau penurunan performa
  3. Terapkan logika percobaan ulang
    • Tunggu beberapa detik sebelum mencoba lagi
    • Gunakan backoff eksponensial untuk beberapa percobaan
  4. Dapatkan dukungan
    • Jika kesalahan berlanjut, hubungi dukungan dengan menyertakan detail permintaan Anda
    • Sertakan payload permintaan dan stempel waktu yang tepat
Kesalahan server biasanya bersifat sementara dan umumnya teratasi secara otomatis.

​
Artinya

503 Layanan Tidak Tersedia - Server untuk sementara mengalami beban berlebih atau sedang menjalani pemeliharaan.

​
Penyebab umum

  • Lalu lintas tinggi menyebabkan beban berlebih sementara
  • Periode pemeliharaan terjadwal
  • Batas kapasitas server telah tercapai
  • Masalah infrastruktur jaringan

​
Solusi

  1. Tunggu dan coba lagi
    • Tunggu 30-60 detik sebelum mencoba lagi
    • Kesalahan ini biasanya teratasi setelah beban kembali seimbang
  2. Terapkan percobaan ulang cerdas
    • Gunakan backoff eksponensial (mulai dari 1 dtk, lalu 2 dtk, 4 dtk, dan seterusnya)
    • Tetapkan batas maksimum percobaan ulang (3-5 percobaan)
    • Tambahkan jitter untuk menghindari efek thundering herd
  3. Periksa pemeliharaan
    • Tinjau Halaman Status Helius untuk pemeliharaan terjadwal
    • Sesuaikan rencana Anda dengan periode pemeliharaan yang diumumkan
  4. Distribusikan beban
    • Jika memungkinkan, sebarkan permintaan dari waktu ke waktu
    • Hindari pola lonjakan yang dapat memicu perlindungan terhadap beban berlebih
Kesalahan 503 dirancang agar bersifat sementara - layanan pulih secara otomatis saat beban server menurun.

​
Artinya

504 Waktu Tunggu Gateway Habis - Server tidak menerima respons dari layanan hulu dalam periode waktu tunggu.

​
Penyebab umum

  • Masalah konektivitas jaringan
  • Operasi kompleks melampaui batas waktu tunggu
  • Respons blockchain lambat saat terjadi kemacetan jaringan tinggi
  • Permintaan data besar memerlukan waktu pemrosesan terlalu lama

​
Solusi

  1. Periksa koneksi Anda
    • Pastikan koneksi internet Anda stabil
    • Uji dengan permintaan sederhana untuk mengeliminasi kemungkinan masalah lokal
  2. Optimalkan permintaan besar
    • Pecah permintaan batch besar menjadi bagian-bagian yang lebih kecil
    • Gunakan paginasi untuk kueri dengan volume data besar
    • Pertimbangkan penggunaan koneksi WebSocket untuk data waktu nyata
  3. Terapkan waktu tunggu
    • Tetapkan nilai waktu tunggu yang sesuai dalam kode klien Anda (30-60 detik)
    • Tangani kesalahan waktu tunggu dengan baik melalui percobaan ulang
  4. Pantau status layanan
Waktu tunggu gateway yang habis sering kali menunjukkan kemacetan jaringan atau operasi yang kompleks. Pertimbangkan untuk memecah permintaan besar menjadi bagian-bagian yang lebih kecil.

​
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 waktu nyata.