Dapatkan Saldo

Mengembalikan saldo USD saat ini untuk akun terautentikasi.

Dapatkan Saldo

GET /v1/balance

curl -X GET "https://api.zelnum.com/api/v1/balance" \
  -H "X-API-Key: YOUR_KEY_HERE"

{
  "balance": "5.230000"
}

Field	Tipe	Deskripsi
`balance`	string	Saldo tersedia dalam USD, tetap 6 angka desimal.

Informasi kunci

Mengembalikan metadata kunci yang dipakai pada permintaan. Rahasia kunci tidak pernah dikembalikan — hanya awalan bertopeng — agar Anda tahu kunci mana yang dipakai tanpa membocorkan kredensial.

GET /v1/api-key

curl -X GET "https://api.zelnum.com/api/v1/api-key" \
  -H "X-API-Key: YOUR_KEY_HERE"

{
  "api_key_id": 12,
  "masked_key": "ck_xxxxxxxxx…****",
  "last_used": "2026-09-12T09:14:03.000000Z",
  "created_at": "2026-08-30T11:02:44.000000Z"
}

Field	Tipe	Deskripsi
`api_key_id`	integer	Pengenal kunci — berguna saat menghubungi dukungan.
`masked_key`	string	Awalan bertopeng. Kunci teks biasa tidak pernah dikembalikan di sini.
`last_used`	string \| null	Waktu permintaan terautentikasi terakhir dengan kunci ini.
`created_at`	string	Waktu kunci dibuat.

Permintaan API dibatasi per kunci API, per grup endpoint:

Endpoint	Batas
`GET /v1/balance` · `GET /v1/api-key`	60 permintaan / menit per API key (120 / menit per IP)

Error

Status	`code`	Penyebab
`401`	`unauthorized`	Kunci API hilang, tidak valid, atau tidak aktif.
`403`	`account_banned`	Akun ditangguhkan. Hubungi dukungan.
`429`	—	Batas laju tercapai — lihat Batas laju.

Kedua endpoint berbagi bucket umum: 60 permintaan / menit per kunci API.