← Zurück zu Downloads

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

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 →