Skip to main content
Helius API menggunakan kunci API untuk mengautentikasi permintaan. Setiap permintaan API harus menyertakan kunci API Anda untuk memverifikasi identitas dan izin Anda.
Kunci API Anda adalah informasi sensitif yang memberikan akses ke akun Helius Anda. Jangan pernah mengeksposnya dalam kode sisi klien, repositori publik, atau area yang dapat diakses melalui browser.

Memulai

1. Buat Kunci API Anda

1

Sign up or log in

Buat akun di Dasbor Helius atau masuk ke akun Anda yang sudah ada.
2

Navigate to API Keys

Buka bagian Kunci API di bilah sisi dasbor Anda.
3

Generate a new key

Klik Buat Kunci API Baru dan berikan nama deskriptif untuk proyek Anda (misalnya, “Aplikasi Produksi”, “Lingkungan Pengembangan”).
4

Copy and secure your key

Segera salin kunci API Anda dan simpan dengan aman. Anda tidak akan dapat melihatnya lagi setelah meninggalkan halaman tersebut.

2. Menggunakan Kunci API Anda

Sertakan kunci API Anda sebagai parameter kueri dalam semua permintaan:

Memulai (Untuk Agen)

Agen dapat mendaftar akun Helius, membuat proyek, dan menghasilkan kunci API secara terprogram menggunakan Helius CLI. Untuk petunjuk lengkap, baca: https://dashboard.helius.dev/agents.md

Instal Helius CLI

Buat Pasangan Kunci

Isi Saldo Dompet yang Dihasilkan (Hanya Pembayaran Otomatis)

Lewati langkah ini jika membayar melalui tautan pembayaran yang dihosting (mode pendaftaran default, diselesaikan dengan helius signup --resume). Pembayaran otomatis (--pay) membayar dari pasangan kunci lokal: kirim 1 USDC dan 0,001 SOL ke alamat dompet yang diberikan pada Langkah 2.

Daftar dan Dapatkan Kunci API

Praktik Terbaik Keamanan

Environment Variables

Simpan kunci API Anda dalam variabel lingkungan, bukan dalam kode sumber Anda.

IP Restrictions

Atur pembatasan IP untuk kunci API Anda di dasbor guna membatasi akses ke alamat atau rentang IP tertentu.

Separate Keys

Gunakan kunci API yang berbeda untuk lingkungan pengembangan, staging, dan produksi guna mengisolasi penggunaan dan meningkatkan keamanan.

Monitor Usage

Periksa penggunaan API Anda secara berkala di dasbor untuk mendeteksi pola yang tidak biasa atau potensi masalah keamanan.

Pengelolaan Rahasia

Batas Laju & Penggunaan

Batas laju bervariasi berdasarkan paket langganan. Pantau penggunaan Anda di Dasbor Helius untuk memastikan penggunaan tetap berada dalam batas yang dialokasikan.

Memahami Batas Laju

  • Permintaan per detik: Berdasarkan tingkat langganan Anda
  • Kuota permintaan bulanan: Total permintaan yang diizinkan per siklus penagihan
  • Toleransi lonjakan: Lonjakan jangka pendek di atas batas laju dasar Anda

Menangani Batas Laju

Pemecahan Masalah

Gejala: Error 401 Unauthorized atau “Invalid API Key”Solusi:
  • Pastikan kunci API Anda benar dan belum dibuat ulang
  • Pastikan Anda menyertakan kunci API sebagai parameter kueri: ?api-key=YOUR_KEY
  • Pastikan tidak ada spasi atau karakter tambahan dalam kunci API Anda
  • Pastikan kunci API Anda belum kedaluwarsa atau dicabut
Gejala: Error 429 Too Many RequestsSolusi:
  • Periksa penggunaan Anda saat ini di dasbor
  • Terapkan exponential backoff dalam logika percobaan ulang Anda
  • Pertimbangkan untuk meningkatkan paket Anda agar mendapatkan batas yang lebih tinggi
  • Optimalkan permintaan Anda untuk mengurangi panggilan yang tidak diperlukan
Gejala: Error 403 ForbiddenSolusi:
  • Pastikan pembatasan IP tidak memblokir permintaan Anda
  • Pastikan langganan Anda mencakup akses ke endpoint tersebut
  • Pastikan kunci API Anda memiliki izin yang diperlukan

Langkah Berikutnya

Quickstart Guide

Mulai lakukan panggilan API pertama Anda dengan Helius

API Reference

Jelajahi semua endpoint dan metode yang tersedia

Rate Limits

Pahami batas laju dan opsi peningkatan paket

Dashboard

Pantau penggunaan API Anda dan kelola kunci

Dukungan

Perlu bantuan terkait autentikasi atau memiliki pertanyaan tentang kunci API?

Discord Community

Bergabunglah dengan Discord kami untuk mendapatkan bantuan secara langsung dan dukungan komunitas

Email Support

Hubungi tim dukungan kami secara langsung