HighMedia Design Licence Server

HighMedia Design Licence Server

📊 Statistiken

🔑 Neuen Key erstellen

📄 Lizenzübersicht

Status Lizenz-Key Software Basis / Addons Bindung Kunde Wartung Ablauf Aktion

🖥️ Software & Produkte

🔍 Lizenz-Validator

Testen Sie Lizenzschlüssel gegen das System.

API Dokumentation

Technische Referenz für die Anbindung externer Systeme. Klicken Sie auf einen Endpunkt für Details.

GET /health System-Status Check

Gibt den aktuellen Zustand des Servers zurück.

Parameters

Keine Parameter erforderlich.

Server Response
Code: 200

                
Responses
Code Description Links
200 Successful Response
Media type
Example Value
Schema
{ "status": "ok", "timestamp": "..." }
No links
POST /api/validate Lizenz validieren & binden

Die primäre Schnittstelle für Clients zur Validierung und Hardware-Bindung.

Parameters
Request Body (JSON)
Server Response
Code: 200

                
Responses
Code Description Links
200 Successful Response
Media type
Example Value
Schema
{ "success": true, "payload": "signed-data", "signature": "..." }
No links
403 Forbidden (Falscher Key oder Hardware) No links
POST /api/deactivate Hardware-Bindung aufheben

Ermöglicht der Client-Anwendung, die Hardware-Bindung aufzuheben.

Parameters
Request Body (JSON)
Server Response
Code: 200

                

Admin API Endpunkte

POST /api/licenses Neue Lizenz erstellen

Erstellt eine neue Lizenz für ein bestimmtes Produkt. Erfordert eine aktive Admin-Session.

Parameters
Request Body (JSON)
Server Response
Code: 201

                
Pflichtfelder
Feld Typ Beschreibung
product_id number ID des Produkts (aus /api/products)
customer_email string E-Mail des Kunden (optional)
days number Laufzeit in Tagen (Standard: 365)
GET /api/licenses Alle Lizenzen auflisten

Gibt alle Lizenzen zurück. Unterstützt Filterparameter.

Parameter (Query)
Parameter Beschreibung
?search= Suche nach Key oder E-Mail
?software_id= Filter nach Software-ID
?product_id= Filter nach Produkt-ID
?status= Filter: valid | suspended
Server Response
Code: 200

                
PATCH /api/licenses/:key/suspend Lizenz sperren / entsperren

Sperrt (/suspend) oder entsperrt (/unsuspend) eine Lizenz. Gesperrte Lizenzen können nicht validiert werden.

PATCH /api/licenses/HMD-XXXX.../suspend
PATCH /api/licenses/HMD-XXXX.../unsuspend
PATCH /api/licenses/:key/reset-fp Hardware-Bindung zurücksetzen

Löscht den gespeicherten Fingerprint, damit der Kunde sich mit neuer Hardware binden kann.

GET /api/products Alle Produkte auflisten
Parameters
Server Response
Code: 200

                
DELETE /api/products/:id Produkt löschen

Löscht ein Produkt. Schlägt fehl wenn noch Lizenzen referenzieren.

Parameters
Produkt ID
Server Response
Code: 200

                
GET /api/software Alle Software auflisten

Gibt alle Software-Einträge zurück. Mit ?include=products werden die zugehörigen Produkte eingebettet.

Parameters
Server Response
Code: 200

                
POST /api/software Neue Software anlegen
Parameters
Server Response
Code: 201

                
DELETE /api/software/:id Software löschen

Löscht eine Software und alle zugehörigen Produkte (sofern keine Lizenzen existieren).

🛠️ Fehler-Codes

Code Bedeutung
INVALID_KEY Key nicht im System gefunden.
EXPIRED Lizenz ist zeitlich abgelaufen.
FINGERPRINT_MISMATCH Hardwarebindung passt nicht zum PC.

Benutzerhandbuch für Administratoren

Dieses Handbuch unterstützt Sie bei der täglichen Verwaltung Ihrer Software-Lizenzen.

  • Neue Lizenzen erstellen

    Gehen Sie zum **Key Generator**. Geben Sie die Kunden-E-Mail und optional interne Nummern (Kunde/Bestellung) ein. Wählen Sie die Module.
    Tipp: Basis-Module werden automatisch mit ausgewählt, wenn Sie ein abhängiges Feature anklicken.

  • Lizenzen erweitern (Upgrades)

    Suchen Sie die Lizenz im Reiter **Lizenzen** und klicken Sie auf **Bearbeiten**. Sie können neue Module hinzufügen.
    Wichtig: Vorhandene Module können nicht entfernt werden, um die Integrität verkaufter Lizenzen zu schützen.

  • Produktmanagement

    Im Reiter **Produkte** legen Sie fest, was Ihr System lizenzieren kann.
    Abhängigkeiten: Sie können definieren, dass ein Produkt ein anderes voraussetzt (z.B. Feature X benötigt Basis Y). Das System markiert das Basis-Modul dann automatisch im Generator.
    Status & Schutz: Inaktive Produkte werden im Verkauf ausgeblendet. Produkte mit aktiven Verweise können nicht gelöscht werden (Lösch-Schutz).

  • Hilfe bei Kundenproblemen

    Nutzen Sie den **Key-Tester**, um Keys zu prüfen. Wenn ein *Fingerprint Mismatch* vorliegt, hat der Kunde wahrscheinlich seine Hardware getauscht. In diesem Fall muss ein Techniker die Hardwarebindung in der Datenbank zurücksetzen.