VPS anlik metrikleri (CPU/RAM/disk/net)

GET 
/services/:id/status

Virtualizor act=vpsstat cagrisi ile real-time metric. Cache YOK — her cagri Virtualizor master'a gider. Yuksek-frekansli polling icin ozel rate limit bucket'i ayrilmistir.

Rate limit: services_status_300rpm bucket — 300 req/dk per key. Default bucket'tan IZOLE; bayi /auth/balance ile esit zamanli polling yapabilir, sayaclar ayri.

Hata davranisi: Virtualizor down ise 502 doner (graceful degradation YOK — real-time metric icin partial yanit anlamsiz).

Cache: YOK (300 RPM kapasitede 1-2 saniye stale data degeri yok).

Request

Responses

200

Anlik metrikler

Response Headers

X-RateLimit-Limit

services_status_300rpm bucket icin tanimli limit

X-RateLimit-Remaining

Mevcut window'da kalan istek sayisi

X-RateLimit-Reset

Sonraki window basinin Unix epoch'u (UTC saniye)

401

Kimlik dogrulama basarisiz — eksik header, hatali credential, IP whitelist disi veya revoke edilmis key. Detay sizdirilmaz; tum durumlar tek mesaj.

Response Headers

WWW-Authenticate

RFC 7617 Basic Auth challenge

403

Yetki yetersiz — bayi baska bir bayinin service_id'sine erismeye calisti veya admin scope gerektiren endpoint icin yetersiz scope. Mesaj generic tutulur (ServiceOwnershipMiddleware sizinti onler).

404

Hizmet bulunamadi VEYA Virtualizor mapping'i yok

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)

502

Virtualizor master upstream hatasi (timeout / 5xx)