API Documentation

Learn how to integrate the license registration and validation API endpoint into your client applications.

Base URL

http://localhost:9003/api

Validation Basis

Supports Activation-based or Purchase-based checks.

Idempotent Acts

Repeat registration check from the same machine is safe.

POST/register

Register a machine or validate an existing license registration.

Request Parameters

productKey(Required)

The license key to activate.

string
machineId(Required)

Unique hardware ID identifying the machine.

string
customerId(Required)

The Client/Customer ID, e.g. CID-XXXXXX.

string
productId(Required)

The unique product identifier key, e.g. PROD-TEST.

string

Response Behaviors

200 OK (Registration Succeeded / Verified)

Returned for a fresh registration under limits, or if validating an already registered machine (idempotent validation).

403 Forbidden (Limit Exceeded)

Returned when the allowed license count threshold has been fully saturated for this key.

Code Implementation
curl -X POST http://localhost:9003/api/register \
  -H "Content-Type: application/json" \
  -d '{
    "productKey": "KEY-XXXX-XXXX",
    "machineId": "unique-machine-id-123",
    "customerId": "CID-XXXXXX",
    "productId": "PROD-XXXX"
  }'