VPS hizmet detayi (WHMCS + Virtualizor birlesimi)
GET/services/:id
Bayi VPS hizmetinin WHMCS-side bilgileri (domain, IP, fatura periyodu, son odeme tarihi, namespace) ile Virtualizor-side runtime metrikleri (hostname, IP listesi, virt tipi, calisma durumu) birlesir.
VPS_ID resolution: Resmi Virtualizor WHMCS modulu VPS_ID'yi WHMCS
custom field'da tutar — tblcustomfields (fieldname='vpsid',
type='product', relid=PRODUCT_ID) + tblcustomfieldsvalues
(fieldid=customfield.id, relid=SERVICE_ID, value=VPSID). Custom field
tanimlanmamis veya value bos ise vps_id=null doner ve virt payload'i
null olur (whitelabel paketler veya henuz provisionlanmamis hizmetler).
Graceful degradation: Virtualizor master upstream hatasi (timeout,
5xx, auth failure) durumunda 502 yerine 200 doner; virt=null ve
virt_unavailable=true. Bayi en azindan WHMCS bilgisini gorur.
Rate limit: Default bucket (60 req/dk per key).
Request
Responses
- 200
- 401
- 403
- 404
- 429
Hizmet detayi donuldu (virt_unavailable=true ise virt=null olabilir)
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).
Hizmet bulunamadi (tblhosting'de kayit yok)
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)