Kode Error & Referensi Status
Panduan lengkap tentang kode error Smart Money API, kode status HTTP, dan langkah pemecahan masalah. Pahami respons error dan selesaikan masalah integrasi dengan cepat.
Kode Sukses 2xx
Respons sukses menunjukkan permintaan berhasil diproses.
| Kode | Status | Arti |
|---|---|---|
| 200 | OK | Permintaan berhasil. Respons berisi data yang diminta. |
| 201 | Created | Sumber daya berhasil dibuat. Respons mencakup sumber daya baru. |
| 204 | No Content | Permintaan berhasil tetapi tidak ada konten yang dikembalikan (misalnya, DELETE). |
Contoh Respons 200
JSON
{
"success": true,
"data": {
"total": 42,
"positions": [...],
"pagination": {
"page": 1,
"limit": 50
}
},
"timestamp": "2026-03-21T14:35:22Z"
}
Kode Error Klien 4xx
Error klien menunjukkan permintaan tidak valid atau salah format. Perbaiki permintaan dan coba lagi.
| Kode | Status | Penyebab |
|---|---|---|
| 400 | Bad Request | Sintaks permintaan salah. Periksa parameter query, header, dan body permintaan. |
| 401 | Unauthorized | Kredensial autentikasi tidak ada atau tidak valid. Periksa kunci API atau token JWT Anda. |
| 402 | Payment Required | Pembayaran langganan gagal. Perbarui informasi pembayaran di akun Anda. |
| 403 | Forbidden | Telah terautentikasi tetapi tidak memiliki izin untuk sumber daya ini. Paket Anda tidak mencakup fitur ini. |
| 404 | Not Found | Sumber daya tidak ada. Periksa URL endpoint dan parameter. |
| 429 | Too Many Requests | Batas laju terlampaui. Tunggu sebelum mencoba lagi. Periksa header Retry-After. |
| 422 | Unprocessable Entity | Validasi gagal. Parameter permintaan tidak valid atau ada field yang wajib diisi. |
Contoh Error Autentikasi
Kunci API Hilang (401)
JSON
{
"success": false,
"error": {
"code": "AUTH_MISSING_KEY",
"message": "Kredensial autentikasi tidak disertakan.",
"resolution": "Sertakan kunci API di header Authorization: Authorization: Bearer sk_live_..."
},
"timestamp": "2026-03-21T14:35:22Z"
}
Kunci API Tidak Valid (401)
JSON
{
"success": false,
"error": {
"code": "AUTH_INVALID_KEY",
"message": "Kunci API tidak valid atau kedaluwarsa.",
"resolution": "Buat kunci API baru dari konsol Anda di https://smartmoneyapi.com/console"
},
"timestamp": "2026-03-21T14:35:22Z"
}
Pembatasan Laju (429)
Saat kuota API Anda terlampaui, server mengembalikan 429 Too Many Requests. Periksa header respons untuk informasi batas laju:
Header HTTP
X-Requests-Remaining: 0
X-Requests-Limit: 200
X-Requests-Reset: 1711116922
Retry-After: 3600
Respons Error Batas Laju
JSON
{
"success": false,
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"message": "Batas permintaan API harian (10) terlampaui.",
"resolution": "Tingkatkan ke paket Trader ($29/bulan, 1,000 permintaan/hari) atau Pro ($79/bulan, 5.000 permintaan/hari).",
"reset_at": "2026-03-22T09:00:00Z"
},
"timestamp": "2026-03-21T14:35:22Z"
}
Error Validasi (422)
Error validasi terjadi ketika parameter permintaan tidak valid atau ada field yang wajib diisi.
JSON
{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Validasi permintaan gagal.",
"details": [
{
"field": "symbol",
"error": "Pasangan trading tidak valid. Format yang diharapkan: BTCUSDT"
},
{
"field": "min_position_size",
"error": "Harus berupa angka positif"
}
],
"resolution": "Perbaiki error validasi dan coba lagi."
},
"timestamp": "2026-03-21T14:35:22Z"
}
Kode Error Server 5xx
Error server menunjukkan masalah di sisi kami. Ini bersifat sementara dan biasanya cepat terselesaikan. Terapkan logika percobaan ulang dengan eksponensial backoff.
| Kode | Status | Tindakan |
|---|---|---|
| 500 | Internal Error | Error server tak terduga. Coba lagi dengan eksponensial backoff. |
| 502 | Bad Gateway | Gangguan layanan sementara. Coba lagi setelah beberapa detik. |
| 503 | Service Unavailable | Pemeliharaan atau gangguan sementara. Periksa halaman status. Coba lagi setelah interval Retry-After. |
| 504 | Gateway Timeout | Permintaan terlalu lama. Server mungkin telah memprosesnya. Periksa idempotensi. |
Contoh Error Server (503)
JSON
{
"success": false,
"error": {
"code": "SERVICE_UNAVAILABLE",
"message": "Layanan sementara tidak tersedia karena pemeliharaan.",
"resolution": "Silakan coba lagi setelah 5 menit. Pantau status di https://status.smartmoneyapi.com"
},
"timestamp": "2026-03-21T14:35:22Z"
}
Panduan Pemecahan Masalah
401 Unauthorized - Kunci API Tidak Valid
Masalah: Menerima error 401 meskipun memiliki kunci API.
Solusi:
- Verifikasi kunci API disertakan dalam header Authorization dengan awalan "Bearer"
- Periksa apakah kunci API belum kedaluwarsa atau dicabut
- Pastikan Anda menggunakan kunci yang benar (produksi, staging, atau pengembangan)
- Buat kunci API baru dari konsol Anda jika yang saat ini hilang
403 Forbidden - Fitur Tidak Tersedia
Masalah: Mendapatkan error 403 pada endpoint tertentu.
Solusi:
- Periksa tier API Anda. Beberapa endpoint memerlukan paket Trader atau Pro
- Tingkatkan paket Anda di /pricing.html untuk mengakses fitur premium
- Verifikasi kunci API memiliki cakupan yang diperlukan diaktifkan
- Hubungi dukungan jika Anda yakin seharusnya memiliki akses
429 Too Many Requests - Dibatasi Laju
Masalah: Mendapatkan error 429 dan dibatasi laju.
Solusi:
- Terapkan logika percobaan ulang dengan eksponensial backoff (tunggu 1s, 2s, 4s, dst.)
- Cache respons untuk menghindari panggilan API berulang
- Gunakan WebSocket untuk data real-time alih-alih polling endpoint REST
- Tingkatkan paket Anda untuk kuota lebih tinggi (Trader 1,000/hari, Pro 5.000/hari)
- Gabungkan beberapa kueri menjadi satu permintaan jika memungkinkan
400 Bad Request - Parameter Tidak Valid
Masalah: Menerima error 400 dengan permintaan salah format.
Solusi:
- Periksa dokumentasi API untuk parameter wajib dan opsional
- Verifikasi tipe parameter (string vs angka, array vs objek)
- Pastikan JSON valid dan diformat dengan benar
- Gunakan URL endpoint yang benar dengan parameter path yang tepat
- Periksa kesalahan ketik pada nama parameter query
Error Server 5xx - Gangguan Sementara
Masalah: Mendapatkan error 500, 502, 503, atau 504.
Solusi:
- Periksa status layanan di https://status.smartmoneyapi.com
- Terapkan percobaan ulang otomatis dengan exponential backoff (maks 5-10 percobaan)
- Tunggu 30-60 detik sebelum mencoba ulang error 503
- Gunakan header Retry-After untuk menentukan waktu percobaan ulang
- Berlangganan halaman status untuk notifikasi insiden
Format Respons Error
Semua respons error mengikuti format yang konsisten:
JSON
{
"success": false,
"error": {
"code": "ERROR_CODE",
"message": "Pesan error yang mudah dipahami",
"details": {...},
"resolution": "Langkah-langkah untuk menyelesaikan masalah"
},
"timestamp": "2026-03-21T14:35:22Z"
}
Butuh Bantuan Lebih Lanjut?
Periksa dokumentasi API kami atau hubungi dukungan dengan kode error dan detail permintaan Anda.
Referensi API