KeyNexus Documentation

# .env
KEYNEXUS_APP_ID=app_xxxxxxxxxxxx
KEYNEXUS_SECRET_KEY=sk_xxxxxxxxxxxxxxxxxxxx
KEYNEXUS_API_URL=https://keynexus.es/api

// Login con licencia
var loginResult = await KeyNexus.LoginWithLicenseAsync(new LicenseLoginRequest
{
    LicenseKey = "XXXXX-XXXXX-XXXXX-XXXXX",
    Hwid = HardwareInfo.GetHwid() // Obtener HWID del sistema
});

if (loginResult.Success)
{
    // Usuario autenticado
    Console.WriteLine($"Bienvenido, {loginResult.Data.User.Username}");
    Console.WriteLine($"Licencia expira: {loginResult.Data.User.SubscriptionExpiry}");
    
    // Guardar token para futuras peticiones
    KeyNexus.SetSessionToken(loginResult.Data.SessionToken);
}
else
{
    switch (loginResult.ErrorCode)
    {
        case "INVALID_LICENSE":
            Console.WriteLine("Licencia inválida o expirada");
            break;
        case "HWID_MISMATCH":
            Console.WriteLine("Esta licencia está vinculada a otro dispositivo");
            break;
        case "USER_BANNED":
            Console.WriteLine("Tu cuenta ha sido suspendida");
            break;
        default:
            Console.WriteLine($"Error: {loginResult.Message}");
            break;
    }
}

{
  "sub": "user_xxxxxxxxxxxx",        // ID del usuario
  "app": "app_xxxxxxxxxxxx",          // ID de la aplicación  
  "hwid": "abc123def456...",          // HWID del dispositivo
  "sess": "sess_xxxxxxxxxxxx",        // ID de la sesión
  "exp": 1735689600,                  // Fecha de expiración (Unix timestamp)
  "iat": 1735603200,                  // Fecha de emisión
  "iss": "KeyNexus"                    // Emisor del token
}

# Generar una licencia de 30 días
curl -X POST https://keynexus.es/api/licenses/generate \
  -H "Content-Type: application/json" \
  -H "Cookie: token=<tu-session-token>" \
  -d '{
    "applicationId": "<mongodb-object-id>",
    "type": "time-based",
    "duration": 30,
    "quantity": 1,
    "prefix": "PREMIUM"
  }'

# Respuesta
{
  "success": true,
  "message": "1 licencia(s) generada(s)",
  "licenses": [
    {
      "_id": "69323ae1ef49b4fe949c8312",
      "key": "PREMIUM-H8OEL-MR2B7-JIJ5Q",
      "type": "time-based",
      "duration": 30,
      "maxUses": 1,
      "status": "unused"
    }
  ]
}

# Validar licencia desde tu aplicación
curl -X POST https://keynexus.es/api/client \
  -H "Content-Type: application/json" \
  -d '{
    "action": "license",
    "appId": "Loi0W4jxVWVcnXqy",
    "secretKey": "pjJrdQxtbLLcCLIMsyVZ2iHVMZsm9ZEE",
    "key": "R4KEH-1CXTK-XTOJJ-TKVVF",
    "hwid": "TU-HWID-REAL-DEL-SISTEMA"
  }'

# Respuesta exitosa
{
  "success": true,
  "message": "Licencia válida",
  "license": {
    "type": "lifetime",      // o "time-based"
    "expiresAt": null,       // null para lifetime
    "daysLeft": null         // null para lifetime
  }
}

# Respuesta de error
{
  "success": false,
  "message": "HWID no autorizado"
}

// 1. Obtener HWID del sistema
string hwid = GetHWID(); // Ver sección avanzada para implementación

// 2. Validar licencia
var response = await httpClient.PostAsJsonAsync("/api/client", new {
    action = "license",
    appId = "tu-app-id",
    secretKey = "tu-secret-key",
    key = licenseKeyTextBox.Text,
    hwid = hwid
});

var result = await response.Content.ReadFromJsonAsync<LicenseResponse>();

if (result.Success)
{
    // Licencia válida - permitir acceso
    MessageBox.Show($"Bienvenido! Licencia: {result.License.Type}");
    if (result.License.DaysLeft.HasValue)
        MessageBox.Show($"Días restantes: {result.License.DaysLeft}");
}
else
{
    // Error - mostrar mensaje
    MessageBox.Show(result.Message); // "HWID no autorizado", "Licencia expirada", etc.
}