Direkte API

FleetManager-Daten direkt per HTTPS einliefern — ohne Brinkhaus-Tools oder MQTT.

Authentifizierung

Alle Ingest-Endpunkte verwenden Bearer-Token-Authentifizierung. Token werden im FleetManager-Dashboard unter Einstellungen → Tokens erstellt.

Authorization: Bearer fmt_IHR_TOKEN

Pfad-Parameter

Alle Endpunkte verwenden drei Pfad-Slugs:

{kunde} — Kunden-Slug (z.B. mein-kunde)
{maschine} — Maschinen-Slug (z.B. server-01)
{software} — Software-Slug (z.B. meine-app)

Format: ^[a-z0-9][a-z0-9-]*$

Heartbeat

POST /api/ingest/{kunde}/{maschine}/{software}/heartbeat

Regelmäßiges Lebenszeichen. Bleibt der Heartbeat >5 Min. aus, springt die Ampel auf Rot.

curl -X POST https://fleet.example.com/api/ingest/mein-kunde/server-01/meine-app/heartbeat \
  -H "Authorization: Bearer fmt_IHR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "ts": "2026-03-06T12:00:00Z",
    "version": "1.0.0",
    "uptime_seconds": 86400,
    "pid": 12345,
    "ip_addresses": ["192.168.1.10"]
  }'

Alle Felder sind optional. ts wird bei Auslassung serverseitig gesetzt.

Diagnosemeldungen

POST /api/ingest/{kunde}/{maschine}/{software}/diagnostics

Senden Sie Diagnosemeldungen mit Fehlercode und Schweregrad.

curl -X POST https://fleet.example.com/api/ingest/mein-kunde/server-01/meine-app/diagnostics \
  -H "Authorization: Bearer fmt_IHR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {"code": 1001, "message": "MQTT-Verbindung fehlgeschlagen", "severity": 2},
      {"code": 1002, "message": "Konfiguration geladen", "severity": 0}
    ]
  }'

Severity 0 — Info

Normaler Betrieb

Severity 1 — Warning

Eingeschränkter Betrieb

Severity 2 — Error

Kritischer Fehler

Status

POST /api/ingest/{kunde}/{maschine}/{software}/status

Senden Sie den aktuellen Betriebsstatus mit optionalem Snapshot.

curl -X POST https://fleet.example.com/api/ingest/mein-kunde/server-01/meine-app/status \
  -H "Authorization: Bearer fmt_IHR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "running",
    "message": "Alle Systeme betriebsbereit",
    "snapshot": {
      "MQTT-Host": "broker.example.com:1883",
      "Connected": true
    }
  }'

Gültige Statuswerte: running, degraded, error, stopped

Antwortformat

Alle Endpunkte antworten mit:

{"ok": true}    // HTTP 200 — Erfolgreich
{"detail": "..."} // HTTP 403 — Token ungültig oder Kunde nicht berechtigt

Changelog

5.10.0 2026-07-01

Hinzugefügt

Typisierte Status-Werte: Snapshot-Blätter können sich selbst beschreiben ({value, type, unit, label, hint}) — rückwärtskompatibel, Blätter ohne type unverändert

5.8.0 2026-06-03

Geändert

Artefakt-Liste pro Dienst filterbar: GET /api/machines/{id}/artifacts?software=<slug>

5.7.1 2026-06-02

Behoben

Ingest-Upsert race-sicher: gleichzeitige Erstmeldungen derselben Instanz lösten HTTP 500 aus

5.7.0 2026-06-02

Hinzugefügt

Neue optionale Heartbeat-Felder group, location, group_priority, sort_priority — altes Paketformat wird weiterhin akzeptiert

5.6.0 2026-06-02

Hinzugefügt

Artefakt-Upload (gechunkt, fortsetzbar): POST …/artifact-init, PUT …/artifact-chunk/{id}/{n}, POST …/artifact-complete/{id}
Neue Endpunkte GET /api/machines/{id}/artifacts und GET /api/artifacts/{id}/download

5.5.0 2026-06-02

Hinzugefügt

Host-Metriken: POST /api/ingest/{kunde}/{maschine}/logcollector/metrics (idempotent über client_metric_id)
Neuer Endpunkt GET /api/machines/{id}/metrics

5.3.0 2026-05-04

Hinzugefügt

GET /auth/me liefert zusätzlich pending_conversions und email_sha256
Neuer Endpunkt POST /auth/conversions/ack (idempotent)

5.0.0 2026-03-17

Hinzugefügt

Multi-Customer: GET /api/auth/my-customers und POST /api/auth/switch-customer
JWT enthält neuen is_system_admin-Claim

4.16.0 2026-03-17

Geändert

4.13.0 2026-03-11

Hinzugefügt

Agent-Kommandosystem: Module advertisen Kommandos im Snapshot, Warteschlange liefert beim nächsten Agent-Kontakt aus
Kommando-Ack-Endpunkt: Agents bestätigen die Ausführung (Erfolg/Fehler)

4.12.2 2026-03-11

Behoben

Status-Snapshots von Security-Agenten wurden beim Empfang verworfen

4.10.0 2026-03-11

Hinzugefügt

Neuer Endpunkt GET /api/dashboard/license-status

Geändert

GET /api/customers/{id}/license-key liefert zusätzlich Geräteanzahl, Limit-Status und Kulanzfrist

4.9.0 2026-03-10

Hinzugefügt

Neuer Endpunkt GET /api/onboarding/status (Einrichtungsfortschritt)

4.8.0 2026-03-10

Hinzugefügt

Neuer Endpunkt GET /api/support-info (lizenzabhängige Supportkontakte)

4.7.0 2026-03-08

Hinzugefügt

Neuer Ingest-Endpunkt /help für Diagnose-Hilfetexte (DE + EN); Ingest antwortet mit HTTP 202, wenn Hilfetexte fehlen
GET /instances/{id}/help?code=&lang= zum Abrufen von Hilfetexten

4.6.3 2026-03-06

Hinzugefügt

CI: GitLab-Release-Job mit automatischer Changelog-Extraktion

4.4.0 2026-03-04

Hinzugefügt

Diagnose-Whitelist: Musterbasierte Event-Unterdrückung

0.9.0 2026-03-04

Hinzugefügt

OpenAPI-Dokumentation mit Tags und Response-Models
Status-Snapshots: Vollständiger StatusEngine-Baum
Ingest Rejection Log reaktiviert

Kostenlos starten — 5 Geräte inklusive

Fleet Monitoring und Security Compliance in unter 10 Minuten. Keine Kreditkarte nötig.

Kostenlos starten Live-Demo buchen

Sie möchten mit einem Fachmann sprechen?

Klicken Sie den Link und wir kommen kurz ins Gespräch.

Termin vereinbaren →