MuseoTorino API | Reference Guide
Elenco per funzione (versione Beta 0.2):
Ricerca per parola chiave
GET /api/search/...?json={parameters}
Ricerca una qualunque classe di oggetti entity.
Categorie
GET /api/categories
Carica tutte le tipologie di categorie presenti sul sistema.
Entity (Scheda)
GET /api/entity/{sid}
Estrae i dati principali (cartellino) di uno specifico Entity dato il suo sid.
Entity per categoria
GET /api/entities_by_category/{id|sid|guid}/{value}
Ricerca tutte le entity associate ad una specifica categoria dato il suo id,sid o guid.
Entity per tema
GET /api/entities_by_theme/{id|sid|guid}/{value}
Ricerca tutte le entity correlate ad uno specifico tema dato il suo id,sid o guid.
Ricerca per periodo
GET /api/search_by_timeline/start/{start_value}/stop/{stop_value}
Ricerca tutte le entity comprese in un tempo iniziale e finale.
Correlazioni di un entity
GET /api/connections/start/{id|sid|guid}/{value}
Ricerca tutte le entity correlate (in) all'entity definito (out)
Informazioni sulla licenza d'uso
I dati contenuti nei Dataset e le informazioni presenti su www.museotorino.it/api,
ove non diversamente segnalato all’interno dei metadati o in altra documentazione informativa,
sono resi disponibili con
licenza IODL 2.0: “Italian Open Data License”.
La IODL è stata rilasciata da Formez PA,
centro servizi per l’ammodernamento della Pubblica Amministrazione, e regola sia i diritti di
proprietà intellettuale che insistono sui dati pubblicati, sia le
possibilità di utilizzo che di essi se ne può fare nel rispetto delle vigenti Leggi italiane.
A puro titolo esemplificativo, la licenza IODL 2.0 permette di eseguire sui dati diverse operazioni, quali:
- riprodurre;
- distribuire;
- presentare in pubblico;
- includere in opere;
- utilizzarli per scopi commerciali;
- combinarli con altri dati o informazioni;
a condizione che:
- se ne indichi la fonte e la proprietà;
- non si riutilizzino le informazioni in un modo che suggerisca che abbiano carattere di ufficialità.
Informazioni sulle API (Application Program Interface) di MuseoTorino
MuseoTorino rilascia i propri dati in modalità Open Data. Tramite il servizio "MuseoTorino API" si permette a tutti gli utenti, enti o organizzazioni pubbliche e private, di usare i dati presenti sul sito www.museotorino.it secondo la licenza open IODL 2.0, nel rispetto delle leggi vigenti, offrendo diverse possibilità di recupero dei dati: il contenuto di una singola scheda, l'elenco delle schede appartenenti ad uno specifico tema, la ricerca per periodo o per parola chiave. I dati presenti nel sito (ad eccezione delle immagini, coperte da specifico copyright), caso unico nel panorama degli Open Data italiani, possono essere fruiti tramite un accesso a specifiche API che forniscono i dati in tempo reale rispetto a quanto visualizzato sul sito principale. Il formato dei dati è un JSON formattato Un primo caso d'uso interno a MuseoTorino è l'applicazione Il Museo per la fruizione della collezione del museo.
Per informazioni:
Per informazioni circa l'accesso e l'uso delle API, contattare 21Style all'indirizzo email info@21-style.com.
Disclaimer: il servizio è rilasciato in versione beta ed è quindi soggetto a modifiche o indisponibilità senza obbligo di preavviso. Non usare su sistemi in produzione.
