License

Güncellendi 19 Kas 2026 Markdown

Bu sayfa henüz Türkçeye çevrilmedi. İngilizce sürüm gösteriliyor.

POST /api/v1/license/activate

Activate License

Activate a license key for the first time.

Calls /api/v1/verify on WLicense servers with RESPONSE_SECRET signing. The server locks the license to this IP/domain on first verification.

Requires authentication: the license/* prefix is auth-bypassed in middleware for the lock-screen, so this state-mutating endpoint must self-guard. An unauthenticated caller could otherwise overwrite the configured license key and disrupt the running install.

A refusal by the license service answers 400 LICENSE_ACTIVATION_FAILED with the service's wording in message and, when the service gave one, its own code in details.vendor_code. AUTH_FAILED there means the key is already registered to an installation.

Body fields:

Field Type Required Notes
license_key string yes —

Request body example:

JSON
{
  "license_key": "string"
}

Responses:

Status Schema Description
200 object Successful Response
422 HTTPValidationError Validation Error

Response example (200):

JSON
{}

cURL example:

kabuk
curl -X POST \
  -H "X-WHost-Key: $WHOST_API_KEY" \
  -H "X-WHost-Timestamp: $(date +%s)" \
  -H "X-WHost-Nonce: $(openssl rand -hex 16)" \
  -H "X-WHost-Signature: $(compute_hmac)" \
  -H "Content-Type: application/json" \
  -d @body.json \
  https://your-server:2000/api/v1/license/activate

GET /api/v1/license/info

Get License Info

Return detailed license information (key is masked), including account_usage (same shape as in GET /license/status).

Authenticated callers only (HMAC or session): an anonymous request receives 401.

Responses:

Status Schema Description
200 any Successful Response

cURL example:

kabuk
curl -X GET \
  -H "X-WHost-Key: $WHOST_API_KEY" \
  -H "X-WHost-Timestamp: $(date +%s)" \
  -H "X-WHost-Nonce: $(openssl rand -hex 16)" \
  -H "X-WHost-Signature: $(compute_hmac)" \
  https://your-server:2000/api/v1/license/info

GET /api/v1/license/status

Get License Status

Return the current license state.

The panel reads this endpoint before sign-in to draw the lock screen, so anonymous callers receive a minimal payload (state, product_name, license_status). Authenticated callers (HMAC or session) get the full operational record, including account_usage: the hosting accounts in use against the license's account limit (used, limit — null when unlimited —, percent, state: unlimited / ok / warning / full).

Responses:

Status Schema Description
200 object Successful Response

Response example (200):

JSON
{}

cURL example:

kabuk
curl -X GET \
  -H "X-WHost-Key: $WHOST_API_KEY" \
  -H "X-WHost-Timestamp: $(date +%s)" \
  -H "X-WHost-Nonce: $(openssl rand -hex 16)" \
  -H "X-WHost-Signature: $(compute_hmac)" \
  https://your-server:2000/api/v1/license/status

POST /api/v1/license/verify

Force Verify

Force an immediate license re-verification with WLicense servers.

The license/* prefix is auth-bypassed in main.py for the lock-screen, so this endpoint must enforce its own auth check: anonymous callers receive 401; authenticated callers (HMAC or session) trigger the verify.

Responses:

Status Schema Description
200 any Successful Response

cURL example:

kabuk
curl -X POST \
  -H "X-WHost-Key: $WHOST_API_KEY" \
  -H "X-WHost-Timestamp: $(date +%s)" \
  -H "X-WHost-Nonce: $(openssl rand -hex 16)" \
  -H "X-WHost-Signature: $(compute_hmac)" \
  https://your-server:2000/api/v1/license/verify
Hâlâ Yardıma mı İhtiyacınız Var?

Yukarıda bulamadığınız her şey için destek ekibimiz her zaman yanınızda.