API v1 (Legacy)

API v1 provides a single endpoint for license validation. It is the original API version and remains available for backwards compatibility.

Endpoint

Validate License

POST /api/v1/validate

Request Body:

{
  "licenseKey": "XXXXX-XXXXX-XXXXX-XXXXX",
  "productId": 1,
  "productVersion": "1.0.0",
  "hwid": "HARDWARE_ID_STRING",
  "ip": "192.168.1.1",
  "operatingSystem": "Windows 10",
  "osVersion": "10.0.19045",
  "osArchitecture": "amd64",
  "javaVersion": "17.0.1",
  "macAddress": "00:1A:2B:3C:4D:5E"
}

Response (Valid):

{
  "valid": true,
  "message": "License is valid",
  "hardwareLocked": true,
  "iPLocked": true,
  "expiryDate": "2025-12-31T23:59:59",
  "maxIPs": 3,
  "maxHWIDs": 3,
  "totalRequests": 42
}

Response (Invalid):

{
  "valid": false,
  "message": "License not found or invalid"
}

Fields

Field	Required	Description
licenseKey	Yes	The license key to validate
productId	Yes	Product ID to validate against
productVersion	No	Version of the product (for logging)
hwid	No	Hardware ID for HWID locking
ip	No	IP address (for IP binding)
operatingSystem	No	OS name (for request logging)
osVersion	No	OS version (for request logging)
osArchitecture	No	OS architecture (for request logging)
javaVersion	No	Java version (for request logging)
macAddress	No	MAC address (for request logging)