Zum Hauptinhalt springen

Neueste Werte aller Parameter abrufen

Endpunkt​

GET /api/environments/<int:environment_id>/values/latest/<int:number_of_entries>/

Beschreibung​

Diese API ruft die neuesten Werte aller Wasserparameter in einer gegebenen Umgebung ab. Besonders nützlich für Dashboards, bei denen Benutzer auf einen Blick die neuesten Messungen aller überwachten Parameter sehen möchten.

Authentifizierung​

API-Schlüssel

Anfrageparameter​

  • environment_id: Die ID der Umgebung (Ganzzahl)
  • number_of_entries: Die Anzahl der neuesten Einträge, die abgerufen werden sollen (Ganzzahl)

Beispielanfrage​

GET /api/environments/1/values/latest/10/

Antwort​

  • 200 OK: Neueste Werte für jeden Parameter werden zurückgegeben.
[
  {
    "parameter": "pH",
    "values": [
      {
        "measured_at": "2024-09-24T10:30:00Z",
        "value": 7.2,
        "unit": "pH"
      },
      {
        "measured_at": "2024-09-23T10:30:00Z",
        "value": 7.0,
        "unit": "pH"
      }
    ]
  },
  {
    "parameter": "Temperature",
    "values": [
      {
        "measured_at": "2024-09-24T10:30:00Z",
        "value": 24.5,
        "unit": "C"
      }
    ]
  }
]
  • 404 Not Found: Die Umgebung wurde nicht gefunden.
  • 400 Bad Request: Ungültige Anfrageparameter.

Anwendungsfall​

Dieser Endpunkt ist ideal für Echtzeit-Monitoring-Dashboards, bei denen Benutzer schnell die neuesten Wasserparameterwerte aller Parameter in einer Umgebung sehen möchten. Besonders nützlich, wenn du die aktuellen Bedingungen in einer Umgebung überprüfen willst, ohne historische Daten für jeden Parameter einzeln zu durchsuchen.