Servisi WHMCS modul hook'u ile suspend et

POST 
/services/:id/suspend

WhmcsApiClient::moduleSuspend cagirilir. WHMCS kendi virtualizor modulunu tetikler, queue cron Virtualizor suspendvs job'una cevirir. Bizim DB'de mod_reseller_provisions.status='suspended'

• notice='Suspended via API: <reason>' set edilir.

Idempotency-Key: OPSIYONEL (header gelirse middleware uygula). Suspend zaten idempotent (zaten suspended ise WHMCS no-op).

Rate limit: Default bucket (60 rpm) — lifecycle high-frequency degil.

vps_id null: 422 service_not_provisioned (provision olmayan servis suspend edilmez).

Body: {"reason": "..."} opsiyonel (1-255 char). Default: "Suspended via Reseller API". Bayinin WHMCS'inde gosterilen reason ile senkron olabilsin.

Side effect: mod_reseller_webhooks_queue tablosuna service.suspended event'i (status='skipped') yazilir. Faz 2 MVP'de gonderim YOK; v2 worker bu event'leri reseller webhook URL'lerine push eder.

Request

Responses

200

Servis suspend edildi

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

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

Servis bulunamadi

422

VPS henuz provisionlanmamis

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

WHMCS API upstream hatasi (whmcs_upstream_error)