Cagliari Open Data Plus

Web API
Documentazione

Documentazione

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.


Web API v2

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



Endpoint disponibili

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.

DEPRECATED API v1

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


Endpoint disponibili

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.

Contatti

Contattateci liberamente per qualsiasi informazione, suggerimento, per segnalare un bug :P o anche solo per un saluto.

info@cagliariopendata.it