> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Tanya Jawab Umum Kode Kesalahan
> Atasi masalah kode kesalahan HTTP saat menggunakan endpoint RPC Helius - identifikasi dan selesaikan masalah autentikasi, pembatasan laju, dan server yang paling umum
## 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**
```
https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY
```
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](https://dashboard.helius.dev/) 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](/docs/id/api-reference/authentication) 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](https://dashboard.helius.dev/usage) 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**
* Tinjau [Paket & Batas Laju](/docs/id/billing/plans) untuk tingkat yang lebih tinggi
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](https://helius.statuspage.io/) 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](https://helius.statuspage.io/) 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**
* Periksa [Halaman Status Helius](https://helius.statuspage.io/) untuk masalah jaringan
* Cari laporan kemacetan blockchain yang tinggi
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?
Dapatkan bantuan dari tim kami melalui Discord, obrolan, atau dukungan email.
Periksa ketersediaan layanan dan informasi performa secara waktu nyata.