Kod Ralat & Rujukan Status
Panduan komprehensif untuk kod ralat Smart Money API, kod status HTTP, dan langkah penyelesaian masalah. Fahami respons ralat dan selesaikan masalah integrasi dengan pantas.
Kod Kejayaan 2xx
Respons kejayaan menunjukkan permintaan berjaya diproses.
| Kod | Status | Maksud |
|---|---|---|
| 200 | OK | Permintaan berjaya. Badan respons mengandungi data yang diminta. |
| 201 | Dicipta | Sumber berjaya dibuat. Respons termasuk sumber baru. |
| 204 | Tiada Kandungan | Permintaan berjaya tetapi tiada kandungan untuk dikembalikan (contohnya, DELETE). |
Contoh Respons 200
JSON
{
"success": true,
"data": {
"total": 42,
"positions": [...],
"pagination": {
"page": 1,
"limit": 50
}
},
"timestamp": "2026-03-21T14:35:22Z"
}
Kod Ralat Pelanggan 4xx
Ralat pelanggan menunjukkan permintaan tidak betul atau tidak sah. Betulkan permintaan anda dan cuba lagi.
| Kod | Status | Punca |
|---|---|---|
| 400 | Permintaan Tidak Sah | Sintaks permintaan tidak betul. Semak parameter pertanyaan, pengepala, dan badan permintaan. |
| 401 | Tidak Diizinkan | Kredensial pengesahan hilang atau tidak sah. Semak kunci API atau token JWT anda. |
| 402 | Pembayaran Diperlukan | Pembayaran langganan anda gagal. Kemas kini maklumat bil dalam akaun anda. |
| 403 | Dilarang | Dibuktikan tetapi tidak dibenarkan untuk sumber ini. Pelan anda tidak termasuk ciri ini. |
| 404 | Tidak Ditemui | Sumber tidak wujud. Semak URL endpoint dan parameter. |
| 429 | Terlalu Banyak Permintaan | Had kadar terlampau. Tunggu sebelum mencuba lagi. Semak pengepala Retry-After. |
| 422 | Entiti Tidak Boleh Diproses | Pengesahan gagal. Parameter permintaan tidak sah atau medan diperlukan hilang. |
Contoh Ralat Pengesahan
Kunci API Hilang (401)
JSON
{
"success": false,
"error": {
"code": "AUTH_MISSING_KEY",
"message": "Kredensial pengesahan tidak disediakan.",
"resolution": "Sertakan kunci API anda dalam pengepala Authorization: Authorization: Bearer sk_live_..."
},
"timestamp": "2026-03-21T14:35:22Z"
}
Kunci API Tidak Sah (401)
JSON
{
"success": false,
"error": {
"code": "AUTH_INVALID_KEY",
"message": "Kunci API tidak sah atau tamat tempoh.",
"resolution": "Hasilkan kunci API baru dari konsol anda di https://smartmoneyapi.com/console"
},
"timestamp": "2026-03-21T14:35:22Z"
}
Had Kadar (429)
Apabila anda melebihi kuota API anda, pelayan mengembalikan 429 Terlalu Banyak Permintaan. Semak pengepala respons untuk maklumat had kadar:
Pengepala HTTP
X-Requests-Remaining: 0
X-Requests-Limit: 200
X-Requests-Reset: 1711116922
Retry-After: 3600
Respons Ralat Had Kadar
JSON
{
"success": false,
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"message": "Had permintaan API harian (10) terlampau.",
"resolution": "Tingkatkan kepada pelan 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"
}
Ralat Pengesahan (422)
Ralat pengesahan berlaku apabila parameter permintaan anda tidak sah atau medan diperlukan hilang.
JSON
{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Pengesahan permintaan gagal.",
"details": [
{
"field": "symbol",
"error": "Pasangan dagangan tidak sah. Format yang dijangka: BTCUSDT"
},
{
"field": "min_position_size",
"error": "Mesti nombor positif"
}
],
"resolution": "Betulkan ralat pengesahan dan cuba lagi."
},
"timestamp": "2026-03-21T14:35:22Z"
}
Kod Ralat Pelayan 5xx
Ralat pelayan menunjukkan masalah di pihak kami. Ini bersifat sementara dan biasanya diselesaikan dengan cepat. Implementasikan logik percubaan semula eksponen.
| Kod | Status | Tindakan |
|---|---|---|
| 500 | Ralat Dalaman | Ralat pelayan tidak dijangka. Cuba lagi dengan percubaan semula eksponen. |
| 502 | Gerbang Tidak Sah | Gangguan perkhidmatan sementara. Cuba lagi selepas beberapa saat. |
| 503 | Perkhidmatan Tidak Tersedia | Penyelenggaraan atau gangguan sementara. Semak halaman status. Cuba lagi selepas selang Retry-After. |
| 504 | Masa Tamat Gerbang | Permintaan mengambil masa terlalu lama. Pelayan mungkin telah memprosesnya. Semak idempotensi. |
Contoh Ralat Pelayan (503)
JSON
{
"success": false,
"error": {
"code": "SERVICE_UNAVAILABLE",
"message": "Perkhidmatan sementara tidak tersedia kerana penyelenggaraan.",
"resolution": "Sila cuba lagi selepas 5 minit. Pantau status di https://status.smartmoneyapi.com"
},
"timestamp": "2026-03-21T14:35:22Z"
}
Panduan Penyelesaian Masalah
401 Tidak Diizinkan - Kunci API Tidak Sah
Masalah: Menerima ralat 401 walaupun dengan kunci API.
Penyelesaian:
- Sahkan kunci API disertakan dalam pengepala Authorization dengan awalan "Bearer"
- Semak kunci API anda belum tamat tempoh atau dibatalkan
- Pastikan anda menggunakan kunci yang betul (produksi, staging, atau pembangunan)
- Hasilkan kunci API baru dari konsol anda jika kunci semasa hilang
403 Dilarang - Ciri Tidak Tersedia
Masalah: Mendapat ralat 403 pada endpoint tertentu.
Penyelesaian:
- Semak tahap API anda. Sesetengah endpoint memerlukan pelan Trader atau Pro
- Tingkatkan pelan anda di /pricing.html untuk mengakses ciri premium
- Sahkan kunci API mempunyai skop yang diperlukan didayakan
- Hubungi sokongan jika anda percaya anda patut mempunyai akses
429 Terlalu Banyak Permintaan - Had Kadar
Masalah: Mendapat ralat 429 dan had kadar.
Penyelesaian:
- Implementasikan logik percubaan semula eksponen (tunggu 1s, 2s, 4s, dsb.)
- Cache respons untuk mengelakkan panggilan API berlebihan
- Gunakan WebSocket untuk data masa nyata dan bukannya pengundian endpoint REST
- Tingkatkan pelan anda untuk kuota lebih tinggi (Trader 1,000/hari, Pro 5,000/hari)
- Gabungkan pelbagai pertanyaan ke dalam permintaan tunggal jika mungkin
400 Permintaan Tidak Sah - Parameter Tidak Sah
Masalah: Menerima ralat 400 dengan permintaan tidak betul.
Penyelesaian:
- Semak dokumentasi API untuk parameter wajib dan pilihan
- Sahkan jenis parameter (string vs nombor, array vs objek)
- Pastikan JSON sah dan diformat dengan betul
- Gunakan URL endpoint yang betul dengan parameter laluan yang sesuai
- Periksa kesalahan ketik dalam nama parameter query
Ralat Pelayan 5xx - Gangguan Sementara
Masalah: Mendapat ralat 500, 502, 503, atau 504.
Penyelesaian:
- Periksa status perkhidmatan di https://status.smartmoneyapi.com
- Laksanakan percubaan semula automatik dengan backoff eksponen (maksimum 5-10 percubaan)
- Tunggu 30-60 saat sebelum mencuba semula ralat 503
- Gunakan header Retry-After untuk menentukan masa percubaan semula
- Langgan halaman status untuk notifikasi insiden
Format Respons Ralat
Semua respons ralat mengikuti format yang konsisten:
JSON
{
"success": false,
"error": {
"code": "ERROR_CODE",
"message": "Mesej ralat yang boleh dibaca manusia",
"details": {...},
"resolution": "Langkah untuk menyelesaikan masalah"
},
"timestamp": "2026-03-21T14:35:22Z"
}
Perlukan Bantuan Lagi?
Periksa dokumentasi API kami atau hubungi sokongan dengan kod ralat dan butiran permintaan anda.
Rujukan API