Documentazione dell'API

Token

Ogni richiesta porta il token in una delle due intestazioni:

X-Api-Key: mpk_…
Authorization: Bearer mpk_…

Il token è personale: non va pubblicato nel codice di pagine web né condiviso. Ogni token vede solo le stazioni concesse, per la finestra storica concordata.

Elenco delle stazioni

GET /api/v1/stations — stazioni concesse al token, con identificativo, nome, coordinate, quota, località di previsione più vicina, ora dell'ultimo dato e stato.

curl -s https://meteo.facchetti.synology.me/api/v1/stations \
  -H "X-Api-Key: mpk_…"

Ultimo dato di una stazione

GET /api/v1/stations/{id}/latest — ultima osservazione con tutte le grandezze pubblicate, con i nomi del catalogo (es. temp_c, humidity_pct, wind_speed_kmh, rain_day_mm, pressure_rel_hpa, pm10_ugm3). Orari in UTC (ISO 8601).

curl -s https://meteo.facchetti.synology.me/api/v1/stations/{id}/latest \
  -H "Authorization: Bearer mpk_…"

Storico

GET /api/v1/stations/{id}/history?field=temp_c&from=…&to=…&window=1h — serie aggregata di una grandezza: from e to in UTC (ISO 8601), window è il passo di aggregazione (es. 10m, 1h, 1d). L'intervallo non può superare la finestra storica del token.

curl -s "https://meteo.facchetti.synology.me/api/v1/stations/{id}/history?field=temp_c&from=2026-11-01T00:00:00Z&to=2026-11-02T00:00:00Z&window=1h" \
  -H "X-Api-Key: mpk_…"

Limiti e scadenza

• Ogni token ha un numero massimo di richieste al minuto: oltre il limite la risposta è 429 Too Many Requests. Interroga i dati non più spesso di quanto si aggiornano (5–10 minuti).
• Il token può avere una scadenza: dopo la scadenza resta bloccato finché l'associazione non lo rinnova. Il token può anche essere bloccato o revocato in caso di uso non conforme.

Licenza e citazione

I dati restano di proprietà dei gestori delle stazioni e sono concessi con la licenza indicata nel token (di norma CC BY-NC 4.0, uso non commerciale). Va sempre citata la fonte: «Dati Meteopassione – www.meteopassione.com». I dati non possono essere ceduti a terzi.

Errori