Accesso programmatico alle entità del Carteggio Canneti-Fiacchi.
https://digiletclass.unibo.it/api/v1application/jsonTutti gli endpoint di lista restituiscono 25 risultati per pagina. Usa il parametro page per navigare.
Per scaricare tutti i risultati in un'unica risposta, senza paginazione, imposta per_page=all.
{
"page": 1,
"per_page": 25,
"total": 1162,
"total_pages": 47,
"items": [ ... ]
}
GET /api/v1/people?per_page=all
/api/v1/people
Lista paginata delle persone citate nel carteggio.
| Parametro | Tipo | Descrizione |
|---|---|---|
search | string | Ricerca sul nome |
sex | m | f | Filtra per sesso |
birth_from | integer | Anno di nascita minimo |
birth_to | integer | Anno di nascita massimo |
page | integer | Pagina (default: 1) |
per_page | all | Se all, restituisce tutti i risultati senza paginazione |
GET /api/v1/people?search=Canneti&sex=m
{
"page": 1,
"per_page": 25,
"total": 1,
"total_pages": 1,
"items": [ { "id": "DLCL_CF_PC0001", ... } ]
}
/api/v1/people/<id>
Dati di una singola persona per ID.
GET /api/v1/people/DLCL_CF_PC0001
{
"id": "DLCL_CF_PC0001",
"sameAs": "http://viaf.org/viaf/88842923",
"sex": "m",
"pers_names": [
{ "name": "Pietro Canneti",
"lang": "it", "parts": [...] }
],
"birth": "1659-11-21",
"birth_place": "Cremona",
"death": "1730-10-01",
"death_place": "Faenza",
"occupations": ["bibliotecario", "poeta"],
"affiliations": ["Ordine dei Camaldolesi"],
"idnos": [
{ "type": "VIAF", "value": "88842923" },
{ "type": "GND", "value": "1057568929" }
],
"note": null
}
/api/v1/places
Lista paginata dei luoghi.
| Parametro | Tipo | Descrizione |
|---|---|---|
search | string | Ricerca sul nome |
type | string | Tipo (es. settlement) |
country | ISO 3166 | Nazione (es. IT) |
page | integer | Pagina (default: 1) |
per_page | all | Se all, restituisce tutti i risultati senza paginazione |
GET /api/v1/places?type=settlement&country=IT
{
"page": 1, "per_page": 25,
"total": 111, "total_pages": 5,
"items": [ { "id": "DLCL_CF_L0002", ... } ]
}
/api/v1/places/<id>
Dati di un singolo luogo per ID.
GET /api/v1/places/DLCL_CF_L0002
{
"id": "DLCL_CF_L0002",
"sameAs": "https://www.geonames.org/3169561/",
"type": "settlement",
"place_names": [{ "name": "Ravenna", "lang": "it" }],
"location": {
"country": "IT",
"geo": "44.41344, 12.20121",
"street": null, "postCode": null
},
"idnos": [
{ "type": "GND", "value": "4048629-1" },
{ "type": "geonames", "value": "3169561" }
]
}
/api/v1/orgs
Lista paginata delle organizzazioni.
| Parametro | Tipo | Descrizione |
|---|---|---|
search | string | Ricerca sul nome |
type | string | Tipo (es. library) |
country | ISO 3166 | Nazione |
settlement | string | Città (lowercase) |
page | integer | Pagina (default: 1) |
per_page | all | Se all, restituisce tutti i risultati senza paginazione |
GET /api/v1/orgs?type=library&country=IT
{
"page": 1, "per_page": 25,
"total": 25, "total_pages": 1,
"items": [ { "id": "DLCL_CF_O0001", ... } ]
}
/api/v1/orgs/<id>
Dati di una singola organizzazione per ID.
GET /api/v1/orgs/DLCL_CF_O0001
{
"id": "DLCL_CF_O0001",
"sameAs": "http://viaf.org/viaf/122822452",
"type": "library",
"org_names": [
{ "name": "Istituzione Biblioteca Classense",
"lang": "it" }
],
"desc": null,
"idnos": [
{ "type": "GND", "value": "5007734-X" },
{ "type": "VIAF", "value": "122822452" }
],
"location": {
"country": "IT",
"geo": "44.41453, 12.19994",
"street": "Via Alfredo Baccarini 3",
"postCode": "48121",
"settlement": "Ravenna"
}
}
La specifica completa è disponibile in formato OpenAPI 3.1 (YAML). Puoi usarla per esplorare l'API interattivamente, generare client automatici in qualsiasi linguaggio, o integrare i dati in portali come Sampo-UI.
openapi.yamlFile → Import URL: https://digiletclass.unibo.it /api/openapi.yaml
| Codice | Significato |
|---|---|
200 | Successo |
404 | Entità non trovata |
{ "error": "Not found" }
Se utilizzi questa API in una pubblicazione o progetto, cita il dataset TEI di origine:
Manca, Chiara. Carteggio Canneti-Fiacchi: Digital Edition Dataset. Zenodo. https://doi.org/10.5281/zenodo.14234727.