API Documentation

1. Generate License (Admin Only)

Create a new license for a customer after purchase.

Request Body:

{
  "email": "[email protected]",
  "product": "coherence_align",
  "adminSecret": "YOUR_ADMIN_SECRET",
  "orderId": "optional-order-id",
  "maxActivations": 2
}

Response:

{
  "success": true,
  "license_key": "TGRA-A1B2-C3D4-E5F6-1234",
  "email": "[email protected]",
  "product": "coherence_align",
  "license_id": "uuid"
}

2. Activate License (Plugin)

Activate a license on a user's machine. Called automatically by the plugin.

Query Parameters:

• key (required): License key
• hwid (required): Hardware ID of the machine
• machine_name (optional): Name of the machine
• os_info (optional): Operating system information

Example:

GET https://lices.ilyen.tech/api/activate?key=TGRA-A1B2-C3D4-E5F6-1234&hwid=abc123&machine_name=Studio%20PC&os_info=Windows%2011

Response (Success):

{
  "success": true,
  "message": "License activated successfully",
  "activations": 1,
  "max_activations": 2
}

Response (Error - Max Activations):

{
  "success": false,
  "message": "License already activated on 2/2 machines. Please deactivate one first."
}

3. Deactivate License

Remove a license activation from a specific machine.

Request Body:

{
  "key": "TGRA-A1B2-C3D4-E5F6-1234",
  "hwid": "abc123"
}

Response:

{
  "success": true,
  "message": "License deactivated successfully"
}

4. Check License Status

Verify license validity and view activation details.

Query Parameters:

• key (required): License key
• hwid (optional): Check if activated on specific machine

Example:

GET https://lices.ilyen.tech/api/status?key=TGRA-A1B2-C3D4-E5F6-1234&hwid=abc123

Response:

{
  "success": true,
  "license": {
    "email": "[email protected]",
    "product": "coherence_align",
    "max_activations": 2,
    "current_activations": 1,
    "is_active": true,
    "is_activated": true,
    "expires_at": null,
    "created_at": "2025-01-01T00:00:00Z"
  },
  "activations": [
    {
      "hwid": "abc123",
      "machine_name": "Studio PC",
      "os_info": "Windows 11",
      "activated_at": "2025-01-01T12:00:00Z",
      "last_verified_at": "2025-01-15T10:30:00Z",
      "is_active": true
    }
  ]
}

Integration Guide

For Plugin Developers:

1. Generate HWID from user's machine (CPU ID, MAC address, etc.)
2. When user enters license key, call /api/activate
3. Store activation status locally (encrypted)
4. On plugin load, verify with /api/status
5. Handle errors gracefully (network issues, invalid keys, etc.)

For Store Integrations:

1. After successful payment, call /api/generate with customer email
2. Send license key to customer via email
3. Store order_id reference for customer support

Common Error Responses