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 Name | Einheit |
---|---|
PH | pH |
Temperature | °C |
TDS | ppm |
Oxygen | mg/L |
Ammonia | ppm |
Nitrite | ppm |
Nitrate | ppm |
Phosphate | ppm |
Carbon Dioxide | mg/L |
Salinity | ppt |
General Hardness | dGH |
Carbonate Hardness | dKH |
Copper | ppm |
Iron | ppm |
Calcium | ppm |
Magnesium | ppm |
Potassium | ppm |
Chlorine | ppm |
Redox Potential | mV |
Silica | ppm |
Boron | ppm |
Strontium | ppm |
Iodine | ppm |
Molybdenum | ppm |
Sulfate | ppm |
Organic Carbon | ppm |
Turbidity | NTU |
Conductivity | µS/cm |
Suspended Solids | mg/L |
Fluoride | ppm |
Bromine | ppm |
Chloride | ppm |
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"
}