Salta al contenuto

Giovedì 28 Marzo 2024

Cerca nel sito del Comune di Cagliari

Indice


Breadcrumbs
Corpo della pagina
Contenuti principali
Esempi di chiamate REST alle risorse del portale

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