Parko Mobility - API Documentation

📡 Ingestion API

Endpoint-uri pentru trimiterea datelor de la devices/senzori.

POST /api/v1/ingest

Trimite o singură citire de la un senzor.

{
  "tag_name": "S1.PRK01.BAR.B001.STATE",
  "value": 1,
  "timestamp": "2025-03-15T10:23:45Z",
  "quality": "GOOD"
}

POST /api/v1/ingest/batch

Trimite batch de citiri (max 100 per request).

{
  "device_id": "GATEWAY-01",
  "readings": [
    { "tag_name": "S1.PRK01.SYS.X001.OCCUPANCY_PCT", "value": 72.5 },
    { "tag_name": "S1.ENV01.AIR.A001.PM25_UGM3", "value": 34.2 },
    { "tag_name": "S1.UTL01.ELC.M001.ACTIVE_POWER_KW", "value": 12.8 }
  ]
}

🅿️ Parking API

GET /api/v1/parking/overview Overview toate parcările

GET /api/v1/parking/zones/:zoneId Detalii zonă specifică

GET /api/v1/parking/sessions?status=ACTIVE Sesiuni parcare

POST /api/v1/parking/sessions Intrare vehicul (new session)

POST /api/v1/parking/sessions/:id/exit Ieșire vehicul + plată

GET /api/v1/parking/revenue?period=today Statistici venituri

⚡ Utilities API

GET /api/v1/utilities/overview Status contoare electric+gaz

GET /api/v1/utilities/meters?type=ELECTRICITY Lista contoare

GET /api/v1/utilities/meters/:id/readings Citiri contor specific

GET /api/v1/utilities/consumption?period=month Consum agregat

🌬️ Environment API

GET /api/v1/environment/overview Status calitate aer + zgomot

GET /api/v1/environment/aqi AQI curent toate stațiile

GET /api/v1/environment/stations/:id Detalii stație + senzori

GET /api/v1/environment/history/:tagId?period=24h Istoric măsurători

📊 Historian API

POST /api/v1/historian/query Query time-series (raw/1min/1h/1d)

GET /api/v1/historian/current?zone=PRK01 Valori curente (snapshot)

GET /api/v1/historian/tag/:id/history?period=7d Istoric tag specific

GET /api/v1/historian/stats Statistici stocare

🔧 Admin API

GET /api/v1/admin/health Health check

GET /api/v1/admin/dashboard Dashboard aggregat complet

GET /api/v1/admin/tags?zone=PRK01&search= Browse tag registry

GET /api/v1/admin/assets?category=PARKING Browse assets

GET /api/v1/admin/alarms?severity=CRITICAL Alarme active

GET /api/v1/admin/audit Audit log

🧪 Simulator API

POST /api/v1/simulator/generate Generează date istorice (24-72h)

POST /api/v1/simulator/realtime Generează citiri real-time (o iterație)

Simulator-ul generează date realiste cu pattern-uri diurne, trafic în ore de vârf, și variații sezoniere. Folosiți pentru demo și testare.