Lihat saldo, mata uang, dan nilai ketentuan pembayaran untuk akun yang diwakili oleh kredensial API Anda. Operasi ini merupakan pencarian saldo; operasi ini tidak menambahkan dana atau membuat pesanan.
Permintaan
Gunakan kredensial API di sisi server melalui HTTPS. Contoh-contoh ini membaca kredensial dari variabel lingkungan; tidak ada kredensial yang dapat digunakan di dalamnya. Periksa status.code di dalam badan JSON serta status HTTP. Penangan lama ini tidak selalu menetapkan status kesalahan HTTP ketika terjadi kesalahan aplikasi.
curl --user "$MULTITEL_API_USER:$MULTITEL_API_PASSWORD" \
"https://api.multitel.net/v3/getbalance"Tidak diperlukan parameter jalur, kueri, atau badan permintaan.
Respons
Ini adalah contoh struktur respons, bukan data akun atau penawaran harga terkini.
{
"status": {
"code": 200,
"msg": ""
},
"response": {
"balance": "125.50",
"currency": "USD",
"terms": "prepaid"
}
}| Kolom | Arti |
|---|---|
balance | Saldo akun yang tersimpan. Pertahankan presisi desimal saat menggunakan nilai uang. |
currency | Nilai mata uang yang tersimpan untuk akun ini. |
terms | Nilai ketentuan pembayaran akun yang tersimpan. Penangan tidak merinci semua kemungkinan nilai atau menormalkannya; jangan berasumsi bahwa contoh tersebut mencakup semua nilai yang mungkin. |
Kesalahan dan penggunaan
Kegagalan autentikasi menggunakan respons autentikasi yang berlaku bersama di seluruh API. Penangan ini tidak menetapkan kesalahan khusus untuk saldo yang tidak ditemukan maupun paginasi. Saldo yang dikembalikan bukan merupakan pencadangan dana dan tidak menjamin bahwa pesanan berikutnya akan berhasil.