📄️ Homsai Backend v2
Questa documentazione descrive le API REST del backend Homsai v2, una piattaforma per il monitoraggio e l’ottimizzazione di impianti energetici residenziali e industriali.
📄️ Domain Model & Data
Questa sezione introduce il modello di dominio di Homsai e le principali entità con cui lavorerai: plants, devices, sensors e metadati collegati.
📄️ Autenticazione
Questa sezione spiega come funzionano autenticazione e autorizzazione in Homsai Backend v2: token JWT, modello di permessi e convenzioni di sicurezza sugli endpoint.
📄️ Working with endpoints
This section explains how to use Homsai APIs to model a plant: creating and managing plants, devices and sensors, and the recommended client‑side workflow.
📄️ Paginazione, Filtri & Date
Questa sezione spiega come usare i parametri comuni di paginazione, ricerca, filtri e gestione delle date sugli endpoint Homsai.
📄️ Energy Metrics & Forecasts
This section explains how to read consumption, production, energy history, forecasts and PV plant health using Homsai APIs.
📄️ Types & Configuration
Questa sezione descrive le entità di configurazione trasversali in Homsai: tipi di sensori e dispositivi, firme di carico, tipi di dato raccolti e vendor associati a un plant.
📄️ Errori & Troubleshooting
Questa sezione descrive come Homsai restituisce gli errori dalle API, quali codici HTTP vengono usati più spesso e come interpretarli lato client.
📄️ API Reference & Swagger
Questa sezione spiega come accedere alla reference completa delle API Homsai tramite Swagger UI e come utilizzarla in combinazione con la documentazione “wiki”.
📄️ SDKs & Esempi di Codice
Questa sezione raccoglie esempi pratici di utilizzo delle API Homsai in vari contesti, utilizzando cURL e client HTTP comuni. Gli esempi riusano gli endpoint più importanti descritti nelle altre sezioni.