La versione attuale delle API è la v2 ed è la versione raccomandata. Essa supporta i formati JSON e RDF nella sintassi JSON-LD.
IMPORTANTE: Le API v1 sono deprecate e verranno eliminate, ne sconsigliamo l'utilizzo.
Tutti gli endpoint sono disponibili solamente in HTTPS.
Il base URL degli endpoint è: https://www.cagliariopendata.it/api/v2
Tutti gli endpoint restituiscono i dati sia in formato JSON che JSON-LD.
Per negoziare il formato della rappresentazione è possibile utilizzare l'header Accept. Per esempio: Accept: application/json, Accept: application/ld+json
oppure la notazione puntata .json, .jsonld alla fine dell'endpoint URL.
Le date/ora sono specificate in formato ISO 8601: yyyy-MM-ddTHH:mm:ss.SSSZ
Solo mediante HTTP GET
/stations, restituisce tutte le postazioni installate in città con relativi sensori. Esempio JSON | Esempio JSON-LD.
/stations/:id, restituisce la rappresentazione di una stazione dato il suo id. Esempio JSON | Esempio JSON-LD.
/stations/:id/data?start=[data/ora]&end=[data/ora], restituisce i dati sul traffico rilevati da una stazione dato il suo id, nell'intervallo di tempo specificato. Esempio JSON | Esempio JSON-LD.
/sensors/:id/data?start=[data/ora]&end=[data/ora], restituisce i dati sul traffico rilevati da un sensore dato il suo id, nell'intervallo di tempo specificato. Esempio JSON | Esempio JSON-LD.
Questa versione delle API è deprecata e verrà eliminata presto. Per tutti i nuovi progetti è consigliabile invece utilizzare la v2.
Gli endpoint sono disponibili solamente in HTTPS.
Il base URL degli endpoint è quindi: https://www.cagliariopendata.it/api/v1
Tutti gli endpoint restituiscono i dati in formato JSON.
Le date/ora sono specificate in formato ISO 8601: yyyy-MM-ddTHH:mm:ss.SSSZ
Solo mediante HTTP GET
/stations, restituisce tutte le postazioni installate in città con relativi sensori. Esempio.
/stations/:id, restituisce la rappresentazione di una stazione dato il suo id. Esempio.
/stations/:id/data?start=[data/ora]&end=[data/ora], restituisce i dati sul traffico rilevati da una stazione dato il suo id, nell'intervallo di tempo specificato. Esempio.
/sensors/:id/data?start=[data/ora]&end=[data/ora], restituisce i dati sul traffico rilevati da un sensore dato il suo id, nell'intervallo di tempo specificato. Esempio.
Contattateci liberamente per qualsiasi informazione, suggerimento, per segnalare un bug :P o anche solo per un saluto.