GIS Care sendet bei Alarmen und Heartbeats automatisch JSON-Daten per HTTP POST an alle aktiven Weiterleitungs-Server.

🔗 Verbindungsparameter

🚨 Alarm-Payload (type: "alarm")

Wird gesendet wenn ein Mitarbeiter einen Alarm auslöst (Sturz, Bewegungslosigkeit, Check-in verpasst, etc.)

{
  "type": "alarm",
  "source": "gis_care",
  "timestamp": "2025-01-15T14:30:00+01:00",
  "data": {
    "alarm_id": 42,
    "user_id": 5,
    "username": "mustermann",
    "scenario": "fallDetection",
    "severity": "critical",
    "message": "Möglicher Sturz erkannt! Hohe Beschleunigung...",
    "was_cancelled": 0,
    "event_type": "triggered",
    "latitude": 51.1657,
    "longitude": 10.4515,
    "timestamp": "2025-01-15T14:30:00+01:00"
  }
}

💓 Heartbeat-Payload (type: "heartbeat")

Wird periodisch gesendet (Standard: alle 30 Sekunden) solange die App aktiv ist.

{
  "type": "heartbeat",
  "source": "gis_care",
  "timestamp": "2025-01-15T14:30:00+01:00",
  "data": {
    "user_id": 5,
    "username": "mustermann",
    "timestamp": "2025-01-15T14:30:00+01:00",
    "monitoring_active": true
  }
}

🔌 Test-Payload (type: "test")

Wird beim Klick auf "Verbindung testen" gesendet.

{
  "type": "test",
  "source": "gis_care",
  "timestamp": "2025-01-15T14:30:00+01:00",
  "data": {
    "message": "GIS Care Verbindungstest"
  }
}

📝 Empfangsserver einrichten

Ihr externer Server muss einen POST-Endpoint bereitstellen der JSON empfängt. Minimal-Beispiel (PHP):

<?php
$input = json_decode(file_get_contents('php://input'), true);
$type = $input['type'];       // "alarm", "heartbeat" oder "test"
$data = $input['data'];       // Nutzdaten
$apiKey = $_SERVER['HTTP_X_API_KEY'] ?? '';

// API-Key prüfen (empfohlen)
if ($apiKey !== 'IHR_GEHEIMER_KEY') {
    http_response_code(403);
    exit;
}

// Verarbeitung je nach Typ
if ($type === 'alarm') {
    // Alarm weiterverarbeiten, z.B. an Leitstelle senden
    $scenario = $data['scenario'];
    $severity = $data['severity'];
    $user = $data['username'];
    // ...
}

http_response_code(200);
echo json_encode(['received' => true]);
?>

⚠️ Wichtige Hinweise

• Weiterleitungen sind fire-and-forget — Fehler blockieren nicht den Alarm-Prozess
• Timeout: 3s Connect + 5s Response — langsame Server werden übersprungen
• Ihr Server sollte mit HTTP 2xx antworten, sonst wird ein Fehler protokolliert
• Latitude/Longitude können null sein wenn der Benutzer kein GPS hat
• Alle Texte (message, username) sind UTF-8 kodiert
• Derzeit werden nur Alarme und Heartbeats weitergeleitet, kein User-Info