GET /api/obrasDevuelve el catálogo completo de obras con sus metadatos públicos.
ETSO ofrece una API pública para consultar los metadatos de las obras del catálogo desde otros proyectos. La API está pensada para reutilizar identificadores, títulos, atribuciones, enlaces y el resultado estilométrico de cada obra.
La información se entrega en formato JSON y puede utilizarse para integrar los datos de ETSO en catálogos, visualizaciones, buscadores o herramientas de investigación.
GET /api/obrasDevuelve el catálogo completo de obras con sus metadatos públicos.
GET /api/obras/{id-o-slug}Devuelve una sola obra usando su identificador o su slug público.
| Campo | Descripción |
|---|---|
id | Identificador estable de la obra. |
slug | Identificador legible usado en las URLs públicas. |
title | Título tal como viene en la base de datos, incluido el artículo final cuando exista. |
displayTitle | Título transformado con el mismo proceso que utiliza la web de ETSO. |
titleVariants | Otros títulos de la obra tal como vienen en la base de datos. |
displayTitleVariants | Otros títulos transformados con el mismo proceso que utiliza la web. |
genre | Género de la obra. |
origin | Procedencia o fuente del texto usado por ETSO. |
textState | Estado del texto dentro del catálogo. |
addedOn | Fecha de incorporación al catálogo, cuando consta. |
resultado1 | Resultado estilométrico de la obra en forma de frase. |
flags | Indicadores booleanos sobre informe, resumen, examen de autorías y acceso textual. |
traditionalAttributionText | Atribución tradicional lista para mostrar. |
traditionalAttributionPhrase | Frase de atribución tradicional con texto, Markdown, HTML y partes enlazables. |
stylometryAttributionText | Atribución estilométrica lista para mostrar. |
traditionalAttribution | Atribución tradicional normalizada. |
stylometryAttribution | Atribución estilométrica normalizada. |
resources | Enlaces públicos relacionados dentro de ETSO. |
Las respuestas se sirven con caché pública: public, max-age=3600, s-maxage=86400, stale-while-revalidate=604800. Para integraciones externas se recomienda cachear localmente la respuesta y no llamar a la API en cada renderizado.
Consulta de una obra concreta y respuesta completa:
https://etso.es/api/obras/la-francesa-laura {
"meta": {
"contentPolicy": {
"includesFullText": false,
"includesSummaries": false,
"excludedFields": [
"fullText",
"text",
"shortSummary",
"summaryText",
"resumen_breve",
"resumen_largo"
]
}
},
"work": {
"id": "DESCONOCIDO_FrancesaLaura",
"slug": "la-francesa-laura",
"title": "Francesa Laura, La",
"displayTitle": "La francesa Laura",
"titleVariants": [],
"displayTitleVariants": [],
"genre": "Comedia",
"origin": "El texto procede de la edición de Cuéllar y Vega.",
"textState": "Bueno",
"addedOn": "2021/03",
"resultado1": "Los analisis de estilometria permiten asociar esta obra de forma clara con el perfil autorial de Lope de Vega Carpio.",
"flags": {
"inAuthorshipExam": true,
"hasSummary": true,
"hasReport": true,
"hasTextAccess": true
},
"traditionalAttributionText": "Desconocido",
"traditionalAttributionPhrase": {
"text": "Obra de atribución desconocida.",
"markdown": "Obra de atribución [desconocida](https://etso.es/autores/desconocido).",
"html": "Obra de atribución <a href=\"/autores/desconocido\">desconocida</a>.",
"parts": [
{
"kind": "text",
"value": "Obra de atribución "
},
{
"kind": "author",
"value": "desconocida",
"authorId": "desconocido",
"href": "/autores/desconocido",
"url": "https://etso.es/autores/desconocido"
},
{
"kind": "text",
"value": "."
}
]
},
"stylometryAttributionText": "Lope de Vega Carpio [Segura]",
"traditionalAttribution": {
"groups": [
{
"members": [
{
"authorId": "desconocido",
"authorName": "Desconocido"
}
]
}
],
"connector": "and",
"rawExpression": "desconocido"
},
"stylometryAttribution": {
"groups": [
{
"members": [
{
"authorId": "vega_carpio_lope_de",
"authorName": "Lope de Vega Carpio",
"confidence": "segura"
}
]
}
],
"connector": "and",
"rawExpression": "vega_carpio_lope_de[segura]"
},
"resources": {
"work": "/obras/la-francesa-laura",
"summary": "/obras/la-francesa-laura/resumen",
"report": "/informes/analisis-estilometrico-la-francesa-laura",
"textAccess": [
{
"label": "Texto BITESO",
"href": "/biteso/francesa-laura-la",
"kind": "biteso"
}
]
}
}
}