Mulai di sini
Autentikasi
Setiap panggilan membawa kunci API Anda di body permintaan. Kunci mengidentifikasi akun, menerapkan batas rate-nya, dan membatasi setiap aksi pada data akun tersebut.
Di mana menempatkan key
Kirim key sebagai field key di dalam body request yang di-form-encode. Auth berbasis header tidak didukung — spesifikasi v2 menggunakan parameter body demi kompatibilitas dengan SDK reseller yang sudah ada.
Content-Type: application/x-www-form-urlencoded
key=YOUR_API_KEY&action=servicesCara mengirim permintaan
Kirim POST dengan kolom formulir (application/x-www-form-urlencoded) atau objek JSON dengan nama datar yang sama. Body maksimal 32 KB. Parameter yang tidak dikenal diabaikan, dan nilai kosong dianggap tidak ada. Metode lain apa pun ditolak dengan METHOD_NOT_ALLOWED.
Apa yang diperiksa pada setiap permintaan
Kunci, akun, dan sakelar API diperiksa ulang di setiap panggilan, sehingga akun yang ditangguhkan atau kunci yang dicabut langsung berhenti berfungsi. Akun harus aktif dan alamat emailnya terverifikasi.
- 401
INVALID_KEY
Invalid API keyKunci hilang, salah, atau dicabut. Perbaiki dulu permintaannya.
- 403
INACTIVE_ACCOUNT
Account suspendedAkun ditangguhkan. Perbaiki dulu permintaannya.
- 403
EMAIL_UNVERIFIED
Email verification requiredAlamat email akun belum diverifikasi. Perbaiki dulu permintaannya.
- 503
API_DISABLED
The API is temporarily disabledAPI dimatikan sebentar. Retry-After menyebutkan kapan mencoba lagi. Mencoba ulang bisa membantu.
- 405
METHOD_NOT_ALLOWED
Use POSTPermintaan bukan POST. Perbaiki dulu permintaannya.
- 413
BODY_TOO_LARGE
Request body too largeBody permintaan terlalu besar. Perbaiki dulu permintaannya.
key=YOUR_API_KEY&action=balance{
"error": "Invalid API key",
"error_code": "INVALID_KEY",
"retryable": false
}Membuat dan mengganti kunci
Key dibuat dan dicabut dari /dashboard/api. Key mentah ditampilkan tepat sekali. Server menyimpan verifier satu arah dan identifier pendek yang tidak rahasia, sehingga nilai mentahnya tidak dapat dipulihkan nanti.
Maksimum 5 key aktif
per akun. Key lama dapat dicabut satu per satu.Ganti tanpa downtime.
Buat key pengganti, perbarui integrasi Anda, lalu cabut key lama. Key yang dicabut ditolak pada request baru.Sesi dashboard aktif diperlukan.
Pembuatan memerlukan sesi dashboard terautentikasi yang tidak sedang menyamar. Tidak ada permintaan kode email atau password tambahan.
Yang tidak bisa dilakukan kunci API
Kunci API v3 terbatas pada tindakan yang terdokumentasi dan tidak dapat mengakses sesi dasbor yang telah masuk atau data akun lain.
- Menarik atau mentransfer saldo.
- Mengubah email akun, password, atau pengaturan 2FA.
- Membuat atau mencabut API key lain melalui API.
- Mengakses endpoint admin atau moderasi.
Jaga keamanan kunci Anda
- Hanya di sisi server. Jangan pernah menyematkan API key dalam bundle browser, aplikasi mobile, atau client apa pun yang bisa didekompilasi pihak lain.
- Gunakan environment variable. Jangan commit key ke git. File
.envharus masuk ke.gitignore. - Cabut saat dicurigai. Jika key terekspos di log, screenshot, atau chat bersama, buat pengganti lalu cabut key tersebut.
- Gunakan webhook untuk mengurangi polling jika berguna. Pengiriman bersifat best-effort dengan retry, jadi buat handler idempotent dan rekonsiliasi state penting melalui
action=status.