Le funzioni disponibili hanno una propria URI e possono essere invocate indipendentemente, offrendo agli sviluppatori una scelta flessibile di funzionalità da integrare secondo una loro logica applicativa.
A titolo di esempio vengono riportate di seguito alcune chiamte al metodo GET che viene utilizzato per effettuare le interrogazioni e ottenere i dati richiesti.
La URI della risorsa messa a disposizione viene completata mediante l'aggiunta di alcuni parametri che permettono di accedere a liste di contenuti, al dettaglio di uno singolo, impostare varie tipologie di filtro.
Esempio 1 - Chiamata alla risorsa CMS/contents che restituisce la lista dei contenuti attualmente pubblicati di tipo Uffici in formato JSON.
Codice SUF
URI chiamata API per ricerca identificativi
www.comune.cagliari.it/portale/api/rs/it/jacms/contents.json?contentType=SUF
Esempio chiamata API con filtro che permette di ordinare per Titolo (denominazione Ufficio)
http://www.comune.cagliari.it/portale/api/rs/it/jacms/contents.json?contentType=SUF&filters=(order=ASC;attributeFilter=true;key=Titolo)
Esempio chiamata alla risorsa CMS/content che restituisce tutto il
corpo del contenuto di tipo ufficio individuato dal codice SUF102330, in formato json:
http://www.comune.cagliari.it/portale/api/rs/it/jacms/content?id=SUF102330
Esempio chiamata API con filtro che restituisce l'elenco degli uffici assegnati ad una determinata categoria (nell'esempio la categoria indicata corrisponde agli uffici del Servizio Demografico)
http://www.comune.cagliari.it/portale/api/rs/it/jacms/contents?contentType=SUF&categories=org_ser_dem_elet_dec_cim
Esempio 2 - Chiamata alla risorsa CMS/contents che restituisce la lista dei contenuti attualmente pubblicati di tipo Notizie/Eventi in formato XML.
Codice NWS
URI chiamata API per ricerca identificativi
http://www.comune.cagliari.it/portale/api/rs/it/jacms/contents?contentType=NWS
Esempio chiamata API con filtro per categoria e data inizio pubblicazione a partire da una certa data e con ordinamento decrescente
http://www.comune.cagliari.it/portale/api/rs/it/jacms/contents?contentType=NWS&categories=at01_ambiente&filters=(order=DESC;attributeFilter=true;key=DataInizioPubblicazione;start=01/05/2017)
Esempio categorie tematiche utilizzabili: at01_ambiente, at02_attivita_prod_turismo, at03_cultura_spettacolo, at24_innovazione, at05_istruzione, at07_lavoro_e_formazione, at10_politiche_sociali, at14_sport_tempo_libero
Esempio chiamata alla risorsa CMS/content che restituisce tutto il corpo del contenuto di tipo notizie individuato dal codice NWS191333
http://www.comune.cagliari.it/portale/api/rs/it/jacms/content?id=NWS191333
Esempio 3 - Chiamata alla risorsa risorsa Custom -elencoRimozioni- che restiuisce l'elenco in formato XML delle rimozioni degli autoveicoli, effettuate dalla polizia municipale.
Esempio chiamata con il parametro -dataDa- (data della rimozione). Restituisce tutte le rimozioni a partire dalla data indicata.
http://www.comune.cagliari.it/portale/api/rs/it/cagliari/elencoRimozioni?dataDa=01/01/2017
Esempio chiamata con il parametro data e modivo. Restituisce tutte le rimozioni a partire dalla data e causale indicata. Il codice 177 corrisponde ad -attraversamento pedonale-
http://www.comune.cagliari.it/portale/api/rs/it/cagliari/elencoRimozioni?dataDa=01/01/2017&motivo=177
Esempio 4 - Chiamata alla risorsa custom -gareEContratti-. Restituisce l'elenco delle gare d'appalto, in formato XML e JSON, con riferimento all'anno di competenza. (sono disponibile per i seguenti anni: 2013,2014,2015,2016,2017)
Esempio chiamata con il parametro -anno-. Restituisce il dettaglio delle gare effettuate nell'anno indicato.
http://www.comune.cagliari.it/portale/api/rs/it/jpTrasparenza/gareEContratti?anno=2017
http://www.comune.cagliari.it/portale/api/rs/it/jpTrasparenza/gareEContratti.json?anno=2017