API Previsioni
TorinoMeteo ha sviluppato delle API REST per erogare gratuitamente il servizio delle previsioni del tempo.
Le previsioni meteorologiche fornite sono da considerarsi ad uso ed interesse personale e non mirano in alcun modo a sostituirsi agli organi preposti. L'Associazione Culturale Torinometeo ed il suo staff, non si assumuno alcuna responsabilità per l'uso indebito di tale bollettino.
Per i meno addetti ai lavori abbiamo anche realizzato una libreria javascript che permette di includere semplicemente all'interno del vostro sito le previsioni TorinoMeteo, responsive ed adattabili a qualunque layout.
API previsioni, versione 1.0
Le previsioni redatte da TorinoMeteo si compongono di una situazione generale descrittiva, più le previsioni testuali e grafiche dettagliate per i tre giorni a seguire.
Vedi la documentazione completa
Lista di tutte le situazioni generali più previsioni giorni successivi
Restituisce un json contenente tutti i bollettini pubblicati da TorinoMeteo.
| URL | https://www.torinometeo.org/api/v1/forecast/ |
|---|---|
| Method | GET |
| Content-Type Response | json |
Ultima situazione generale pubblicata più previsioni giorni successivi
Restituisce un json contenente l'ultimo bollettino pubblicato da TorinoMeteo.
| URL | https://www.torinometeo.org/api/v1/forecast/get-last/ |
|---|---|
| Method | GET |
| Content-Type Response | json |
Lista previsioni dettagliate singolo giorno
Restituisce un json contenente una lista di previsioni dettagliate per data.
| URL | https://www.torinometeo.org/api/v1/forecast/day/ |
|---|---|
| Method | GET |
| Content-Type Response | json |
Previsione dettagliata singolo giorno
Restituisce un json contenente la previsione dettagliata per la data fornita nel formato informatico AAAA-MM-DD.
| URL | https://www.torinometeo.org/api/v1/forecast/day/AAAA-MM-DD/ |
|---|---|
| Method | GET |
| Content-Type Response | json |
Descrizione oggetti in risposta
Descriviamo qui la struttura dei dati trasmessi in formato json in risposta alle request descritte più sopra.
Oggetto "Bollettino"
L'oggetto bollettino ha le seguenti proprietà:
| Proprietà | Tipo di dato | Significato |
|---|---|---|
| id | Integer | Identificativo univoco |
| date | Date | Data nel formato AAA-MM-DD |
| pattern | String | Descrizione situazione generale |
| day_forecasts | Array | Lista di oggetti "Previsione" |
Oggetto "Previsione"
L'oggetto previsione ha le seguenti proprietà:
| Proprietà | Tipo di dato | Significato |
|---|---|---|
| forecast | Integer | Identificativo del bollettino associato |
| date | Date | Data nel formato AAA-MM-DD |
| image12 | URL | URL immagine previsionale 00:00 - 12:00 |
| image24 | URL | URL immagine previsionale 12:00 - 24:00 |
| text | String | Situazione generale |
| temperatures | String | Situazione temperature |
| winds | String | Situazione vento |
| reliability | Integer | Affidabilità su scala 1-100 |