GET /api/obras公開メタデータ付きの作品カタログ全体を返します。
API
ETSO は、カタログ内の作品と著者を照会し、識別子、タイトル、著者帰属、文体計量分析の結果、リンクを再利用できる公開 API を提供しています。
情報は JSON 形式で返され、ETSO のデータをカタログ、可視化、検索システム、研究ツールに統合できます。
エンドポイント
GET /api/obras/{id-publicId-o-slug}識別子または公開 slug を使って単一の作品を返します。
GET /api/autoresメタデータと関連作品の五つのカテゴリを含む著者一覧全体を返します。
GET /api/autores/{id-o-key}数値 ID またはテキストキーで、単一の著者のメタデータと五つの作品カテゴリを返します。
レスポンスのフィールドを選択
4 つのエンドポイントはいずれも、公開された最上位フィールド名をカンマで区切る任意の fields パラメーターを受け付けます。以下の表に各リソースのフィールドを示します。resources などのオブジェクトを選択すると、その公開オブジェクト全体を返します。
fields を省略するとすべての公開フィールドを返します。選択後も authors、author、works、work のラッパーと該当する meta 情報は保持されます。空の選択、不明または非公開のフィールド、resources.work のような入れ子のパスは HTTP 400 を返します。
https://etso.es/api/obras/690677?fields=publicId,displayTitle{
"meta": {
"contentPolicy": {
"includesFullText": false,
"includesSummaries": false,
"excludedFields": [
"fullText",
"text",
"shortSummary",
"summaryText",
"resumen_breve",
"resumen_largo"
]
}
},
"work": {
"publicId": 690677,
"displayTitle": "La francesa Laura"
}
}作品のメタデータ
| フィールド | 説明 |
|---|---|
id | 作品の安定した識別子。 |
publicId | 作品の安定した数値公開識別子。 |
slug | 公開 URL で使用される読みやすい識別子。 |
title | データベース内のタイトル。末尾の冠詞がある場合はそれも含みます。 |
displayTitle | ETSO のウェブサイトと同じ処理で変換されたタイトル。 |
titleVariants | データベース内の作品の別タイトル。 |
displayTitleVariants | ウェブサイトと同じ処理で変換された別タイトル。 |
genre | 作品のジャンル。 |
origin | ETSO が使用するテキストの出典または由来。 |
textState | カタログ内でのテキストの状態。 |
addedOn | 記録がある場合のカタログ追加日。 |
bitesoPublishedOn | BITESO での公開日。不明な場合は null。 |
summaryPublishedOn | 要約の公開日。不明な場合は null。 |
resultado1 | 作品の文体計量結果を文として示したもの。 |
flags | 報告書、要約、作者帰属調査、テキストアクセスに関する真偽値。 |
traditionalAttributionText | 表示用の伝統的帰属。 |
traditionalAttributionPhrase | テキスト、Markdown、HTML、リンク可能な部分を含む伝統的帰属文。 |
stylometryAttributionText | 表示用の文体計量帰属。 |
traditionalAttribution | 正規化された伝統的帰属。 |
stylometryAttribution | 正規化された文体計量帰属。 |
resources | ETSO 内の関連する公開リンク。 |
帰属オブジェクト内の authorId は著者の公開数値識別子、authorKey は ETSO の URL に使用されるテキストキーです。これらは帰属オブジェクトのプロパティであり、最上位フィールドではありません。
完全なレスポンスの例
特定の作品のクエリと完全なレスポンス：
https://etso.es/api/obras/690677{
"meta": {
"contentPolicy": {
"includesFullText": false,
"includesSummaries": false,
"excludedFields": [
"fullText",
"text",
"shortSummary",
"summaryText",
"resumen_breve",
"resumen_largo"
]
}
},
"work": {
"id": "DESCONOCIDO_FrancesaLaura",
"publicId": 690677,
"slug": "la-francesa-laura",
"title": "Francesa Laura, La",
"displayTitle": "La francesa Laura",
"titleVariants": [],
"displayTitleVariants": [],
"genre": "Comedia",
"origin": "El texto procede de la edición crítica de Álvaro Cuéllar y Germán Vega García-Luengos (Gredos, 2023).",
"textState": "Bueno",
"addedOn": "2021/03",
"bitesoPublishedOn": "2026-06-18",
"summaryPublishedOn": "2026-06-18",
"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": "Lope de Vega Carpio",
"traditionalAttributionPhrase": {
"text": "Obra atribuida a Lope de Vega Carpio.",
"markdown": "Obra atribuida a [Lope de Vega Carpio](https://etso.es/autores/vega_carpio_lope_de).",
"html": "Obra atribuida a <a href=\"/autores/vega_carpio_lope_de\">Lope de Vega Carpio</a>.",
"parts": [
{
"kind": "text",
"value": "Obra atribuida a "
},
{
"kind": "author",
"value": "Lope de Vega Carpio",
"authorId": 364,
"authorKey": "vega_carpio_lope_de",
"href": "/autores/vega_carpio_lope_de",
"url": "https://etso.es/autores/vega_carpio_lope_de"
},
{
"kind": "text",
"value": "."
}
]
},
"stylometryAttributionText": "Lope de Vega Carpio [Segura]",
"traditionalAttribution": {
"groups": [
{
"members": [
{
"authorId": 364,
"authorKey": "vega_carpio_lope_de",
"authorName": "Lope de Vega Carpio"
}
]
}
],
"connector": "and",
"rawExpression": "vega_carpio_lope_de"
},
"stylometryAttribution": {
"groups": [
{
"members": [
{
"authorId": 364,
"authorKey": "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/la-francesa-laura",
"kind": "biteso"
}
]
}
}
}推奨される使い方
レスポンスは公開キャッシュ付きで配信されます： public, max-age=3600, s-maxage=86400, stale-while-revalidate=604800. 外部連携ではレスポンスをローカルにキャッシュし、レンダリングごとに API を呼び出さないことを推奨します。
フィールドの選択はレスポンスサイズとデータ転送量を減らします。それ自体でリクエスト数を減らしたり、データベース照会をすべてなくしたりするものではありません。