License
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:
{
"license_key": "string"
}
Responses:
| Status | Schema | Description |
|---|---|---|
200 |
object |
Successful Response |
422 |
HTTPValidationError |
Validation Error |
Response example (200):
{}
cURL example:
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:
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):
{}
cURL example:
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:
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
Yukarıda bulamadığınız her şey için destek ekibimiz her zaman yanınızda.