Revamp printer activation settings

This commit is contained in:
2026-05-31 22:20:22 +02:00
parent e3c153fb0f
commit cfe141efc9
8 changed files with 329 additions and 133 deletions
+14 -4
View File
@@ -12,7 +12,7 @@ Alle Endpunkte erfordern einen Bearer Token (JWT oder API-Key):
Authorization: Bearer {token}
```
`/printers/register`, `/jobs/next`, `/jobs/:id/image`, `/jobs/:id/printed` und `/jobs/:id/error` benötigen keine spezifische Permission, nur einen gültigen Token. `POST /jobs` und `POST /preview` erfordern `VIEW_SCANNER`.
`/printers/register`, `/printers/:printerId/deactivate`, `/jobs/next`, `/jobs/:id/image`, `/jobs/:id/printed` und `/jobs/:id/error` benötigen keine spezifische Permission, nur einen gültigen Token. `POST /jobs` und `POST /preview` erfordern `VIEW_SCANNER`.
## 1. Job manuell anlegen (Frontend -> Backend)
@@ -67,9 +67,9 @@ Content-Type: image/png
Body: binäres PNG-Bild.
## 3. Drucker registrieren (Benutzeraktion in den Agent-Einstellungen)
## 3. Drucker aktivieren/deaktivieren (Benutzeraktion in den Agent-Einstellungen)
Der Agent ruft diesen Endpunkt nicht automatisch beim Start auf. Der Benutzer registriert die freigegebenen lokalen Windows-Drucker bewusst über die Agent-Einstellungen.
Der Agent ruft diesen Endpunkt nicht automatisch beim Start auf. Der Benutzer aktiviert lokale Windows-Drucker bewusst über die Agent-Einstellungen.
```http
POST /api/label-print-agent/printers/register
@@ -84,7 +84,8 @@ Content-Type: application/json
"windowsPrinterName": "Zebra GK420d",
"dpi": 203,
"defaultWidthMm": 101,
"defaultHeightMm": 76
"defaultHeightMm": 76,
"active": true
}
```
@@ -98,6 +99,15 @@ Content-Type: application/json
{ "ok": true }
```
Zum Deaktivieren entfernt der Benutzer den Haken `Aktiv`; der Agent ruft standardmäßig folgenden Endpunkt auf:
```http
POST /api/label-print-agent/printers/{printerId}/deactivate
Content-Type: application/json
```
Der Request Body entspricht dem Aktivieren, aber mit `"active": false`.
## 4. Nächsten Druckjob abrufen (Agent-Polling)
```http