Kisa omurlu (60s) NoVNC baglanti bilgisi
POST/services/:id/vnc-token
Browser tarafinda direkt wss://{host}:{port}/{websockify_path} URL'sine
baglanmak icin kullanilir (port = Virtualizor enduser novnc proxy portu,
ornn. 4083; HAM VNC/RFB portu DEGIL). API HIC bu websocket akisina PROXY
YAPMAZ — sadece baglanti bilgisi (host/port/password/expires_at) doner.
Idempotency-Key KABUL ETMEZ. Header gelse bile IGNORE edilir (route'a IdempotencyMiddleware bagli degil). Sebep: her cagri Virtualizor'da YENI password uretir; cached eski password 60s sonra expire olur ve bayi "sifre gecersiz" hatasi alirdi.
Rate limit: Default bucket (60 req/dk) — high-frequency degil.
vps_id null: 422 service_not_provisioned.
Response:
expires_at: server'in hesapladigi UTC ISO8601 (now + 60s)ttl_seconds: 60 (sabit, client kolay parse etsin)password: short-lived NoVNC parolasi (LogMaskervnc_passwordalanini maskeler)host/port/websockify_path: bayi browser'inin baglanacagi node bilgisi
Request
Responses
- 200
- 401
- 403
- 422
- 429
- 502
VNC baglanti bilgisi (60s gecerli)
Response Headers
Bu key icin tanimli dakika basi limit
Mevcut window'da kalan istek sayisi
Sonraki window basinin Unix epoch'u (UTC saniye)
Kimlik dogrulama basarisiz — eksik header, hatali credential, IP whitelist disi veya revoke edilmis key. Detay sizdirilmaz; tum durumlar tek mesaj.
Response Headers
RFC 7617 Basic Auth challenge
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).
VPS henuz provisionlanmamis
Dakika basina limit asildi
Response Headers
429 sonrasi tekrar denemeden once beklenmesi gereken saniye (RFC 7231 §7.1.3)
Bu key icin tanimli dakika basi limit
Sonraki window basinin Unix epoch'u (UTC saniye)
Virtualizor upstream hatasi