DTS (Distributed Text Services) 1.0 正式リリースへの対応 ― TEI/XMLテキストAPIの仕様更新記録

- "@context": "https://distributed-text-services.github.io/specifications/context/1-alpha1.json"
+ "@context": "https://dtsapi.org/context/v1.0.json"

- "dtsVersion": "1-alpha"
+ "dtsVersion": "1.0"

{
-   "collection": "/api/v2/dts/collection{?id}",
-   "navigation": "/api/v2/dts/navigation{?resource,ref,down}",
-   "document": "/api/v2/dts/document{?resource,ref}"
+   "collection": "/api/v2/dts/collection{?id,page,nav}",
+   "navigation": "/api/v2/dts/navigation{?resource,ref,start,end,down,tree,page}",
+   "document": "/api/v2/dts/document{?resource,ref,start,end,tree,mediaType}"
}

// JSON-LD レスポンス（Entry Point, Collection, Navigation）
res.set("Content-Type", "application/ld+json");

// Document レスポンス
res.set("Content-Type", "application/tei+xml");

res.set("Link", `</api/v2/dts/collection?id=${resource}>; rel="collection"`);

Content-Type: application/tei+xml; charset=utf-8
Link: </api/v2/dts/collection?id=urn:kouigenjimonogatari.1>; rel="collection"

// 1-alpha: デフォルトで down=1
if (down === undefined) {
  down = "1";
}

// 1.0: down, ref, start/end 全て未指定なら 400
if (down === undefined && !ref && !start && !end) {
  res.status(400).json({ error: "down, ref, or start/end is required" });
  return;
}

  navigationData["ref"] = {
-   "@id": refString,
+   "identifier": refString,
    "@type": "CitableUnit",
    "level": 1,
    "parent": null,
    "citeType": "page"
  }

// ref と start/end は排他
if (ref && (start || end)) {
  res.status(400).json({ error: "ref cannot be used with start/end" });
  return;
}

// start と end は必ずセット
if ((start && !end) || (end && !start)) {
  res.status(400).json({ error: "start and end must be used together" });
  return;
}

<lg xml:id="waka-001" type="waka" rhyme="tanka">
  <l n="1">かきりとて</l>
  <l n="2">わかるゝ道の</l>
  <l n="3">かなしきに</l>
  <l n="4">いかまほしきは</l>
  <l n="5">いのちなりけり</l>
</lg>

{
  "citationTrees": [
    {
      "@type": "CitationTree",
      "citeStructure": [
        { "citeType": "page", "citeStructure": [{ "citeType": "line" }] }
      ]
    },
    {
      "@type": "CitationTree",
      "identifier": "waka",
      "description": "和歌（短歌）による引用構造",
      "citeStructure": [
        { "citeType": "waka", "citeStructure": [{ "citeType": "ku" }] }
      ]
    }
  ]
}

# デフォルト（ページ/行）でナビゲーション
/navigation?resource=urn:kouigenjimonogatari.1&down=1

# 和歌ツリーで一覧取得
/navigation?resource=urn:kouigenjimonogatari.1&tree=waka&down=1

# 和歌ツリーで全階層（歌 + 句）取得
/navigation?resource=urn:kouigenjimonogatari.1&tree=waka&down=-1

# 特定の和歌のXMLを取得
/document?resource=urn:kouigenjimonogatari.1&tree=waka&ref=waka-001

# 第3句のみ取得
/document?resource=urn:kouigenjimonogatari.1&tree=waka&ref=waka-001.3

if (treeString === "waka") {
  buildWakaMembersMap(xmlDoc, membersMap);  // <lg type="waka"> を探索
} else {
  buildDefaultMembersMap(xmlDoc, membersMap);  // <seg corresp="..."> を探索
}

npm test