Klima API Dokumentation

Diese API stellt aktuelle Daten der Klimastationen der Stadt Mannheim bereit.

Eine Authentifizierung ist nicht erforderlich.

Allgemeines

• Basis-URL: https://api.smartmannheim.de
• Format: Alle Antworten sind JSON.
• Authentifizierung: Keine – die API ist ohne Login nutzbar.

Rate Limiting

Die Metadaten der Sensoren können 4x pro Stunde abgefragt werden.

Die Messdaten eines Sensors können 6x pro Stunde abgefragt werden. Insgesamt sind 30 Anfrage pro Stunde möglich, d. h. es können für 5 Sensoren alle 10 Minuten die Daten abgefragt werden.

Endpunkte

1. Metadaten der Klimasensoren abrufen

GET /climate/sensors

Gibt eine Liste aller verfügbaren Sensoren zurück.

Parameter: Keine

Beispielantwort:

{
  "sensorCount": 2,
  "sensors": [
    {
      "id": "0004A30B00F738F5",
      "name": "Sensor A",
      "position": [
        8.521318,
        49.493182
      ],
      "paramSet": 0
    },
    {
      "id": "0004A30B00F72EED",
      "name": "Sensor AB",
      "position": [
        8.47506735843768,
        49.4963184820373
      ],
      "paramSet": 1
    }
  ],
  "paramSets": [
    [
      "airHumidity",
      "atmosphericPressure",
      "dewPoint",
      "irradiation",
      "maxIrradiation",
      "maxTemperature",
      "minTemperature",
      "temperature"
    ],
    [
      "averageWindDirection",
      "averageWindSpeed",
      "minWindSpeed",
      "windGust1s",
      "windGust3s",
      "windGustDirection"
    ]
  ]
}

2. Messwerte eines Sensors abrufen

GET /climate/measurements/:id

Gibt die aktuellen Messwerte des angegebenen Sensors zurück. Der Zeitraum umfasst automatisch die letzten 60 Minuten.

Pfadparameter:

Beispiel:

GET /climate/measurements/12356789

Beispielantwort:

{
  "sensorId": "12356789",
  "measurementsCount": 2,
  "data": [
    {
      "timestamp": "2026-07-23T10:10:00.000Z",
      "temperature": 22.4,
      "airHumidity": 61.2    
      },
      {
      "timestamp": "2026-07-23T10:00:00.000Z",
      "temperature": 20.1,
      "airHumidity": 60.5
    }
  ]
}

Nicht alle Felder sind bei jedem Sensor vorhanden – es werden nur die Werte zurückgegeben, die der Sensor tatsächlich liefert.

Fehlercodes