MuseoFerrara API | Reference Guide

Informazioni
Licenza d'uso
API

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.museoferrara.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 MuseoFerrara

MuseoFerrara rilascia i propri dati in modalità Open Data.

Tramite il servizio "MuseoFerrara API" si permette a tutti gli utenti, enti o organizzazioni pubbliche e private, di usare i dati presenti sul sito www.museoferrara.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 e dei testi digitalizzati, 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 MuseoFerrara è 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.