Dati e API
Il database BlackItaly è un dato di ricerca aperto. Questa pagina dice con quale licenza potete riusarlo, come citarlo e come leggerlo in modo automatico.
Licenza
I dati del database (schede delle persone, delle reti e dei luoghi, con le loro relazioni) sono pubblicati con licenza Creative Commons Attribuzione 4.0 Internazionale (CC BY 4.0): potete copiarli, ridistribuirli e rielaborarli, anche per scopi commerciali, a condizione di citare la fonte. I testi delle pagine del sito e le immagini restano soggetti ai diritti indicati caso per caso. Il riuso dei dati che riguardano persone identificabili resta soggetto alle Regole deontologiche per i trattamenti a fini di ricerca storica richiamate all'ingresso del sito.
Come citare
Il database: BlackItaly. The Italian Peninsula and the Atlantic Slavery: a Forgotten History, database, Fondazione Bruno Kessler – Istituto Storico Italo-Germanico, Trento, https://blackitaly.fbk.eu (consultato il giorno/mese/anno).
Una singola scheda: titolo della scheda, in BlackItaly, indirizzo della scheda. Per esempio: «La Chiapella Geronimo», in BlackItaly, https://blackitaly.fbk.eu/s/ita/item/748.
API
Il sito è costruito con Omeka S e ne espone l'API REST, in sola lettura e senza registrazione, all'indirizzo https://blackitaly.fbk.eu/api. Le risposte sono in JSON-LD (il contesto è in /api-context); i risultati sono paginati con i parametri page e per_page. Alcuni esempi:
- tutte le persone del database:
/api/items?item_set_id=86&resource_class_id=94 - una scheda:
/api/items/748 - le reti:
/api/items?item_set_id=1204 - le persone di una rete (qui la 1212):
/api/items?property[0][property]=298&property[0][type]=res&property[0][text]=1212 - ricerca a testo libero:
/api/items?fulltext_search=Grillo - i marker della mappa:
/api/mapping_features - i campi propri di BlackItaly:
/api/properties?vocabulary_prefix=blackitaly(vocabolariohttps://blackitaly.fbk.eu/blackitaly/)
Documentazione dell'API: omeka.org/s/docs/developer/api.
Che cosa è escluso
L'API restituisce soltanto i dati pubblici. Non sono accessibili le note di lavoro del gruppo di ricerca, le schede ancora in revisione e, fino a gennaio 2027, le schede delle navi e dei viaggi. Il database documenta le persone della penisola italiana coinvolte nella tratta atlantica come mercanti, finanziatori, armatori, capitani e proprietari; non raccoglie schede sulle persone schiavizzate, che compaiono solo quando le fonti le nominano accanto a chi le teneva in schiavitù.
Scaricare tutto il database
Una copia completa del database (CSV e JSON-LD), con un DOI che ne fissa la versione, verrà depositata in un archivio aperto a ogni rilascio; il primo deposito è in preparazione. Nel frattempo i dati si estraggono dall'API.
Contatti
Segnalazioni, correzioni e richieste sul riuso dei dati: fmorelli@fbk.eu.