API pubblica

• GET/api/export/citta.json
  Tutte le città, una riga ciascuna: normali 1961–1990 e 1991–2020, riscaldamento, tendenza per decennio con intervallo di confidenza al 95%, R².
• GET/api/export/citta.csv
  Gli stessi aggregati, in CSV.
• GET/api/export/citta/roma
  Una città per intero: serie annua, anomalie, medie decennali, climatologia mensile, la serie mese-per-anno dietro /mese, i record e il trend. È l'endpoint per rifare i conti da zero.
• GET/api/export/mese.json
  Il mese appena concluso: anomalia nazionale, posto in classifica fra tutti gli stessi mesi dal 1940, serie completa e dettaglio città per città.
• GET/api/export/mari.json
  L'archivio giornaliero della temperatura del mare (media, max, min) per sei punti in mare aperto, dal 24 novembre 2022.
• GET/api/export/mari.csv
  Lo stesso archivio marino, una riga per mare e per giorno.
• GET/api/openapi.json
  La specifica OpenAPI 3.1 di tutto quanto sopra.

Copia e incolla: nessuna autenticazione, nessun header speciale.

curl https://italiarovente.app/api/export/citta.json
curl https://italiarovente.app/api/export/citta/roma
curl https://italiarovente.app/api/export/mese.json
curl https://italiarovente.app/api/export/mari.csv -o mari.csv

Ogni risposta porta con sé dataset_generated_at(quando lo snapshot è stato ricalcolato, non l'ora della richiesta) e dataset_sha256, l'impronta degli aggregati per-città. Riesegui aggregate() sugli stessi dati grezzi di Open-Meteo e devi riottenere esattamente questi numeri e questa impronta. Se non tornano, uno dei due ha sbagliato — e vogliamo saperlo. Impronta attuale: a678395fd9419be45878f352342afc07dc2580b21e3af426ae565c7af32f39db.

• Riscaldamento = normale 1991–2020 meno normale 1961–1990 (due trentenni WMO). Mai un anno recente contro il passato.
• Tendenza = regressione lineare sulle medie annue dei soli anni completi, con intervallo di confidenza al 95% sulla pendenza.
• Anomalia mensile = scarto dalla normale 1961–1990 dello stesso mese di calendario, non dalla media dell'intera serie.
• I mari non hanno una tendenza. La serie inizia nel novembre 2022: tre anni misurano il rumore interannuale, non il clima. Non pubblichiamo una pendenza, e non dovreste calcolarla nemmeno voi.

• I giorni mancanti nella fonte non vengono interpolati: nell'archivio marino manca davvero il periodo 29 gennaio – 11 febbraio 2025, e resta mancante.
• I record giornalieri assoluti ignorano gli ultimi 120 giorni: ERA5 recente (ERA5T) è preliminare e può essere rivisto.
• La copertura dello snapshot cresce build dopo build (Open-Meteo limita le richieste): il dato nazionale mensile dichiara sempre su quante città poggia.
• Non è un servizio meteorologico ufficiale. Uso informativo e divulgativo, non per decisioni critiche.

Gli endpoint sotto /api/export/ sono esplicitamente permessi in robots.txt. L'indice pensato per i modelli è llms.txt, la specifica leggibile a macchina è openapi.json. Tutto il resto sotto /api/ è vietato ai crawler: scrive, costa, oppure è il cron interno.

Uso libero, anche commerciale, con attribuzione a Italia Rovente (italiarovente.app) e alla fonte originale (ERA5 — ECMWF/Copernicus C3S, via Open-Meteo). Nessun rate limit oltre il normale uso corretto della CDN. Se costruisci qualcosa con questi dati, ci fa piacere saperlo.