Zum Hauptinhalt springen

Wasserwerte hinzufügen

Endpunkt

POST /api/environments/<int:environment_id>/values/"

Beschreibung

Dieser Endpunkt ermöglicht es dir, Wasserwerte zu einer bestimmten Umgebung hinzuzufügen. Jede Umgebung gehört einem Benutzer, und du kannst Wasserwerte nur basierend auf der Upload-Frequenz deines Abonnement-Plans einreichen. Dies dient der Ressourcenschonung und verhindert Spam-Anfragen an die API.

Upload-Frequenz

  • Hobby-Plan: Kann alle 12 Stunden neue Wasserwerte hochladen.
  • Business-Plan: Kann alle 3 Stunden neue Wasserwerte hochladen.
  • Advanced-Plan: Kann alle 30 Minuten neue Wasserwerte hochladen.

Wenn du versuchst, Werte vor Ablauf der erlaubten Zeit hochzuladen, erhältst du einen 429 Too Many Requests-Fehler.

Wasserparameter

Die folgenden Wasserparameter werden derzeit vom System unterstützt. Jeder Parameter hat eine zugehörige Einheit:

Parameter NameEinheit
PHpH
Temperature°C
TDSppm
Oxygenmg/L
Ammoniappm
Nitriteppm
Nitrateppm
Phosphateppm
Carbon Dioxidemg/L
Salinityppt
General HardnessdGH
Carbonate HardnessdKH
Copperppm
Ironppm
Calciumppm
Magnesiumppm
Potassiumppm
Chlorineppm
Redox PotentialmV
Silicappm
Boronppm
Strontiumppm
Iodineppm
Molybdenumppm
Sulfateppm
Organic Carbonppm
TurbidityNTU
ConductivityµS/cm
Suspended Solidsmg/L
Fluorideppm
Bromineppm
Chlorideppm

Authentifizierung

  • API-Schlüssel: Du musst mit deinem API-Schlüssel authentifiziert sein, um Wasserwerte hinzuzufügen. Deinen API-Schlüssel findest du unter „Profilinformationen“ oder in deinem „Dashboard“.

Beispielanfrage

Hier ist ein Beispiel, wie du Wasserwerte für eine Umgebung hinzufügst:

Anfrage-URL

POST /api/environments/3/values/

Anfrage-Body

{
"Temperatur": 29.9,
"PH": 8.2,
"TDS": 630
}

Antwort

  • 201 Created: Wasserwerte erfolgreich hinzugefügt.
  • 400 Bad Request: Fehler in der Anfrage, z. B. fehlende oder ungültige Felder.
  • 404 Not Found: Die Umgebung existiert nicht oder gehört nicht zum Benutzer.
  • 429 Too Many Requests: Du versuchst, Werte vor Ablauf der erlaubten Upload-Frequenzzeit hochzuladen.

Beispielantwort

{
"id": 4,
"environment": 3,
"parameter": {
"id": 1,
"name": "PH",
"unit": "pH"
},
"value": "8.200",
"measured_at": "2024-09-23T11:19:09.432111Z"
},
{
"id": 5,
"environment": 3,
"parameter": {
"id": 2,
"name": "Temperatur",
"unit": "°C"
},
"value": "29.900",
"measured_at": "2024-09-23T11:19:09.432111Z"
},
{
"id": 6,
"environment": 3,
"parameter": {
"id": 3,
"name": "TDS",
"unit": "ppm"
},
"value": "630.000",
"measured_at": "2024-09-23T11:19:09.432111Z"
}