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

IODL 2.0 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.

IODL 2.0 Powered by 21Style