Bayi WHMCS kredi bakiyesi (APCu 60s cache)

GET 
/auth/balance

Authenticated bayinin WHMCS kredi bakiyesini doner. Bakiye ONCE read-only WHMCS DB replica'sindan (tblclients.credit) okunur; DB erisilemezse WHMCS HTTP API (GetClientsDetails) fallback'e duser.

Cache: APCu 60 saniye (env: BALANCE_CACHE_TTL_SECONDS, 0 = bypass). Response'ta cached alani cache hit durumunu bildirir.

Currency: Faz 1'de global BALANCE_DEFAULT_CURRENCY (default TRY). Faz 2'de per-client currency WHMCS tblcurrencies join ile gelecek.

Normalize: WHMCS'de client bulunamazsa credit=0.0 doner (404 vermez — entegrasyon tarafinin defensive programlamasi icin daha guvenli default).

Responses

200

Bakiye donuldu

Response Headers

X-RateLimit-Limit

Bu key icin tanimli dakika basi limit

X-RateLimit-Remaining

Mevcut window'da kalan istek sayisi

X-RateLimit-Reset

Sonraki window basinin Unix epoch'u (UTC saniye)

401

Authentication basarisiz

429

Dakika basina limit asildi

Response Headers

Retry-After

429 sonrasi tekrar denemeden once beklenmesi gereken saniye (RFC 7231 §7.1.3)

X-RateLimit-Limit

Bu key icin tanimli dakika basi limit

X-RateLimit-Remaining
X-RateLimit-Reset

Sonraki window basinin Unix epoch'u (UTC saniye)