TerraBytes X1 Gateway

Serverseitig gerendert

Ein Eingang, viele Zielanwendungen

Das Gateway nimmt für den Gira X1 immer dieselbe äußere Struktur an. meta steuert den Request, identity beschreibt das Gerät und parameters enthält die anwendungsspezifischen JSON-Daten, die flexibel an die passende Zielanwendung durchgereicht werden.

Dispatch-Endpunkt Payload-Schema API-Info

Pfad: /api/x1/dispatch Methode: POST Format: meta + identity + parameters

Schnellzugriff

Health /health API-Info /api Beispiel-JSON #payload-schema

API-Funktionen

POST /api/x1/dispatch

validiert die Gateway-Hülle und leitet den Request an die konfigurierte Zielanwendung weiter

GET /api

liefert eine kompakte maschinenlesbare Übersicht über den Dienst und seine Routen

GET /health

einfache Verfügbarkeitsprüfung für Browser, Nginx, Portainer und Monitoring

Hinweise

Der X1 muss nur einen stabilen Eingang kennen. Das interne Routing übernimmt das Gateway.

Nur parameters ist anwendungsspezifisch und kann unverändert an Weather, License oder spätere Systeme durchgereicht werden.

Die äußere Hülle bleibt bewusst klein: meta, identity, parameters.

Payload-Schema

JSON • flexibel

Das Gateway trennt technische Steuerung, Geräteidentität und anwendungsspezifische Nutzdaten sauber voneinander. Dadurch kann derselbe X1-Eingang später beliebige Zielanwendungen bedienen.

{
  "meta": {
    "schemaVersion": "1.0",
    "command": "weather.push",
    "requestId": "b2b8508b-6cc8-4f58-a37a-1d9eb4a2d0f4"
  },
  "identity": {
    "mac": "AA:BB:CC:DD:EE:FF",
    "version": "1.0.0",
    "targetApp": "Weather.Api"
  },
  "parameters": {
    "tenantId": "acme",
    "installId": "000ab3290991",
    "snapshot": {
      "meta": { "updated": "2026-03-10T12:00:00Z" },
      "now": { "temperature": 8.4, "weatherCode": 500 }
    }
  }
}