API

ETSO는 카탈로그의 작품과 저자를 조회하고 식별자, 제목, 저자 귀속, 문체 계량 분석 결과 및 링크를 재사용할 수 있는 공개 API를 제공합니다.

정보는 JSON 형식으로 제공되며 ETSO 데이터를 카탈로그, 시각화, 검색 시스템 또는 연구 도구에 통합하는 데 사용할 수 있습니다.

엔드포인트

GET /api/obras

공개 메타데이터가 포함된 전체 작품 카탈로그를 반환합니다.

GET /api/obras/{id-publicId-o-slug}

식별자 또는 공개 slug를 사용해 단일 작품을 반환합니다.

GET /api/autores

메타데이터와 관련 작품의 다섯 범주를 포함한 전체 저자 목록을 반환합니다.

GET /api/autores/{id-o-key}

숫자 ID 또는 텍스트 키를 사용하여 한 저자의 메타데이터와 다섯 작품 범주를 반환합니다.

응답 필드 선택

네 엔드포인트 모두 공개 최상위 필드 이름을 쉼표로 구분하는 선택적 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"
        }
      ]
    }
  }
}

저자와 관련 작품

저자의 숫자 id는 ETSO 식별자이며 작품 귀속 정보의 authorId와 일치합니다. 텍스트 키 key는 ETSO 저자 URL에서 사용됩니다.

필드	설명
`id`	저자의 공개 숫자 식별자이며 작품 귀속 정보의 authorId와 일치합니다.
`key`	저자 URL에서 사용하는 텍스트 키입니다.
`name`	저자 이름입니다.
`nameVariants`	저자 이름의 다른 표기입니다.
`resources`	저자의 공개 페이지 링크입니다. author는 경로이며 url은 절대 URL입니다.

저자별 작품

각 저자 객체에는 저자 귀속 검토의 저자 페이지에 있는 다섯 범주에 해당하는 작품 숫자 publicId 배열(number[]) 다섯 개가 포함됩니다. 해당 검토에 속한 작품만 웹사이트와 같은 기준으로 포함합니다. 개연성이 있거나 가능한 귀속 및 공동 집필을 포함하며, 미해결된 전통적 귀속이나 문체 계량 분석에 따른 귀속은 각각 해당 측에서 제외합니다. 포함되었다는 것이 확정적인 저자 귀속이나 단독 집필을 뜻하지는 않습니다.

작품이 없는 범주는 []를 반환합니다. 각 범주는 조회한 저자를 기준으로 계산합니다. 각 작품 publicId로 /api/obras/{publicId}를 조회하거나 https://etso.es/obras/{publicId}에 연결할 수 있습니다. 이 링크는 정식 작품 페이지로 리디렉션됩니다.

필드	설명
`relatedWorkPublicIds`	저자와 관련된 작품: 전통적 귀속 또는 문체 계량 분석에 따른 귀속.
`traditionalWorkPublicIds`	전통적으로 귀속되는 작품.
`stylometryWorkPublicIds`	문체 계량 분석으로 뒷받침되는 작품.
`traditionalOnlyWorkPublicIds`	오직 전통적으로만 귀속되는 작품: 이 저자에 대한 문체 계량 분석의 뒷받침이 없음.
`newStylometrySupportedWorkPublicIds`	문체 계량 분석으로 뒷받침되는 새로운 귀속: 이 저자에 대한 전통적 귀속이 없음.

전체 저자와 각 저자의 다섯 작품 목록

https://etso.es/api/autores

한 저자와 다섯 작품 목록

https://etso.es/api/autores/374

한 저자와 관련된 작품만 조회

https://etso.es/api/autores/374?fields=id,relatedWorkPublicIds

권장 사용법

응답은 공개 캐시와 함께 제공됩니다: public, max-age=3600, s-maxage=86400, stale-while-revalidate=604800. 외부 연동에서는 응답을 로컬에 캐시하고 렌더링마다 API를 호출하지 않는 것을 권장합니다.

필드 선택은 응답 크기와 데이터 전송량을 줄입니다. 그 자체로 요청 횟수를 줄이거나 모든 데이터베이스 조회를 없애지는 않습니다.