IoT API Dokumentasjon

POST /api/ingest

Send sensordata til AquaEnergy AI-plattformen. Dette endepunktet aksepterer JSON-data fra IoT-gateways.

Request Headers

Content-Type: application/json
X-API-Key: your-api-key-here (placeholder)

Request Body

{
  "gateway_id": "gateway-001",
  "timestamp": 1234567890,
  "sensors": [
    {
      "id": "sensor-energy-001",
      "type": "energy",
      "value": 123.45,
      "unit": "kWh"
    },
    {
      "id": "sensor-flow-001",
      "type": "flow",
      "value": 25.5,
      "unit": "m3/h"
    },
    {
      "id": "sensor-o2-001",
      "type": "oxygen",
      "value": 95.2,
      "unit": "%"
    },
    {
      "id": "sensor-temp-001",
      "type": "temperature",
      "value": 10.5,
      "unit": "°C"
    }
  ]
}

Response

{
  "status": "ok",
  "message": "Data ingested successfully",
  "gateway_id": "gateway-001",
  "timestamp": 1234567890,
  "sensors_received": 4
}

Sensor Types

  • energy - Energiforbruk (kWh)
  • flow - Vannstrøm (m³/h eller L/min)
  • oxygen - Oksygennivå (mg/L eller %)
  • temperature - Temperatur (°C)
  • vibration - Vibrasjon (g eller m/s²)

Eksempel med cURL

curl -X POST https://your-domain.com/api/ingest \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "gateway_id": "gateway-001",
    "timestamp": 1234567890,
    "sensors": [
      {
        "id": "sensor-energy-001",
        "type": "energy",
        "value": 123.45,
        "unit": "kWh"
      }
    ]
  }'

Merk: API-nøkkel-autentisering er for øyeblikket en placeholder. I produksjon vil dette kreve ekte autentisering og validering.