Format respons & kode error
Semua endpoint memakai format respons yang sama. Cek field success, lalu baca data atau error.
Respons sukses
Status HTTP 2xx dengan success: true. Isi data berbeda per endpoint dan dijelaskan di halaman endpoint masing-masing.
{
"success": true,
"data": { … },
"request_id": "a1b2c3d4e5"
}Respons error
Status HTTP 4xx atau 5xx dengan success: false dan objek error.
{
"success": false,
"error": {
"code": "IP_NOT_WHITELISTED",
"message": "IP 203.0.113.10 tidak terdaftar untuk API key ini.",
"details": { "ip": "203.0.113.10" }
},
"request_id": "a1b2c3d4e5"
}null.request_id
Setiap respons, sukses maupun error, membawa request_id: 10 karakter hex yang unik per request. Simpan di log Anda dan sertakan saat menghubungi tim teknis supaya request-nya bisa langsung kami telusuri.
Kode error
Kode yang bisa dikembalikan oleh endpoint yang tersedia saat ini:
details.details.ip.details.price. Lihat Saldo tidak cukup.Error validasi
Untuk VALIDATION_ERROR dari parameter yang salah, details berisi daftar pesan, satu per masalah. Pesan ini dalam bahasa Inggris.
{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Permintaan tidak valid.",
"details": ["status must be one of the following values: normal, gangguan"]
},
"request_id": "a1b2c3d4e5"
}Batas request
Batas dihitung per Mitra Bisnis, per environment, dalam jendela 1 menit. Cek saldo dan daftar produk masuk kelompok baca dengan batas default 120 request per menit. Batas bisa berbeda per Mitra Bisnis; nilai yang berlaku selalu ada di header respons.
{
"success": false,
"error": {
"code": "RATE_LIMITED",
"message": "Batas 120 permintaan per menit tercapai. Coba lagi dalam 23 detik.",
"details": { "limit": 120, "group": "read", "retry_after_seconds": 23 }
},
"request_id": "a1b2c3d4e5"
}- Saat menerima 429, tunggu sesuai
Retry-Afterlalu ulangi dengan timestamp, nonce, dan signature baru. - Daftar produk tidak perlu diambil di setiap transaksi. Simpan di cache dan perbarui secara berkala.