CBETA API 5.18.7

DILA 2016/2026

更新紀錄

目次

Version 5.x

2026-10-31 Version 5.18.7

  • search/notes、search/title、search/similar 帶 work_type 參數時回傳錯誤訊息 (這幾個索引沒有 work_type 欄位，原本一律回 0 筆)。
  • works 以 time_start 查詢時必須同時指定 time_end，否則回傳錯誤 (原本靜默回空結果)。
  • works 以時間範圍查詢時，佛典成立期間與查詢範圍有重疊即符合； 原本成立期間完整涵蓋查詢範圍的佛典會漏掉。
  • search/toc 以冊號查詢 (例如 T01) 轉址時保留 JSONP 的 callback 參數。
  • 帶無效 API key 的請求也計入每個 IP 的流量限制。
  • odt 檔的 mimetype 不再帶 zip extra field，符合 ODF 規範。
  • 跨冊的卷 (例如 L1557 第 17 卷由 L130 接到 L131) 改為逐冊記錄起訖行號； 原本只記得後半冊，以冊、頁、行定位時，卷的起點與前半冊各行所屬的卷會判斷錯誤。

2026-10-31 Version 5.18.6

  • search/kwic 修正：單卷的 kwic_wo_punc 回傳的前後文與命中位置不符； sort=b 時 negative_lookbehind、negative_lookahead 排除錯對象； NEAR 搭配 sort=b 時結果錯誤 (NEAR 現在忽略 sort 參數)； NEAR 的詞彼此包含時前後文重複輸出文字。
  • NEAR 的空白規則統一：多個空格、tab，或 NEAR 前面沒有空格時， search/all_in_one 的筆數與 KWIC 原本可能是 0 或漏掉第三個詞。
  • works 以冊號範圍查詢時，跨冊佛典 (例如 T0220) 只要與查詢範圍有重疊就會回傳； 原本查詢範圍放寬反而會少掉。
  • search/toc、works 的 creator 系列參數中的 % 與 _ 改為照字面比對。
  • changes 的 lb 參數若不是單一字串，視同未帶參數。
  • search 系列與 search/kwic 的 start、rows 為負數時回傳錯誤訊息。
  • 請求逾時改回 HTTP 504 (原本 search 系列回 200，其他回 408)。

2026-10-24 Version 5.18.4

  • 查詢字串含 $ { } \ 等符號時，search/notes 的 highlight 與 KWIC 的前後字詞統計 改為照字面比對；原本可能漏標 highlight 或回傳錯誤。

2026-10-21 Version 5.18.1

  • KWIC 比對改為不區分拉丁字母的變音符號，與全文檢索一致。 例如搜 Pali Text 也會找到寫成 Pāli Text 的內容；原本 search/all_in_one 會回報 num_found 有筆數、results 卻是空的。顯示的文字仍保留原本的變音符號。 (無法逐字對應的少數字元，例如 æ、ß，仍須輸入原字。)

2026-10-20 Version 5.18.0

2026-10-19 Version 5.17.0

  • search/notes 新增 cursor 參數，可分段取回超過 10 萬筆的結果（例如匯出），詳見： https://cbdata.dila.edu.tw/dev/static_pages/search_notes
  • search/all_in_one、search/notes、search/title 等：start + rows 超過 100,000 時， rows 改為自動截斷，不再回傳錯誤（all_in_one、title 與 4.x 相同）。start 本身仍不得超過 99,999。 search/notes 要取回超過 10 萬筆請改用 cursor。
  • search/notes 的 NEAR 與 Exclude 查詢恢復支援 facet=1（5.0.0 起回傳錯誤）。 NEAR 的 facet hits 改為與 docs 相同（符合的條目數）， 數字會比 4.x 小：4.x 的 hits 是各關鍵詞出現次數的加總，並非 NEAR 組合的次數。
  • 說明：search/notes 的 Exclude 自 5.0.0 起與全文檢索 (search/all_in_one) 同樣以出現次數相減， 出現次數全部被排除的條目才不回傳；4.x 是只要含有排除字串就不回傳。 因此筆數較 4.x 多，例如 "菩薩" -"諸菩薩"：12,691 筆 → 13,002 筆。

2026-10-16 Version 5.15.3

  • 加快 search/toc。
  • 修正 search/toc：同一部佛典的目次結果，每次查詢的順序可能不同； 改為固定依目錄、經文的順序。

2026-10-16 Version 5.15.1

  • chinese_tools/sc2tc、word_seg、word_seg2 的輸入上限為 50000 字，超過時回傳錯誤 (sc2tc 為 HTTP 400，word_seg、word_seg2 沿用各自原本的錯誤格式)。

2026-10-16 Version 5.15.0

  • juans、works/toc、catalog_entry、export/all_creators2、api/collections、textref/data、 openapi.json 支援條件式請求 (ETag)：內容沒有變更時回傳 HTTP 304， 瀏覽器可直接使用已快取的內容。

2026-10-16 Version 5.14.2

  • 加快 search/all_in_one 的 NEAR 查詢，常用字的組合尤其明顯。

2026-10-16 Version 5.14.0

  • Referer 為 .cn 網域時，不再屏蔽太虛大師全書 (TX)、印順法師佛學著作集 (Y) 的內容及這兩位作者，所有來源一律回傳相同的結果。

2026-10-16 Version 5.13.4

  • 修正 works：以冊號範圍 (vol_start、vol_end) 查詢時，跨冊的佛典 (例如 T0220) 會重複出現兩次。
  • 修正 search/all_in_one、search/similar：計算 facet 時，遇到不在藏經清單中的藏經代碼會回傳錯誤。
  • Asia Network API (/api/sections/*)：卷存在但對應的佛典資料缺漏時，改為回傳 HTTP 404 (原本回傳錯誤)。

2026-10-16 Version 5.13.3

  • 修正 search/all_in_one：不加引號、含空格的查詢詞 (例如 Pāli Text Society)， KWIC 原本把每個字分開標示，term_hits 也分開計算 (變成三倍)； 改為整個詞組一起標示與計數，與全文檢索的計數一致。
  • 修正 search/all_in_one：Exclude 查詢的詞組含 | 等字元時，排除條件不會生效。
  • 加快 search/facet、search/variants，以及 search/all_in_one 的 Exclude 查詢加上 facet=1 (例如 "菩薩" -"諸菩薩")。

2026-10-16 Version 5.13.1

  • 修正 search/kwic、search/all_in_one：NEAR 查詢的第二個詞不在某一卷時，整個查詢會失敗。
  • 修正 Referer 標頭為空字串時，所有 API 都會回傳錯誤。
  • JSONP 的 callback 參數只接受合法的 JavaScript 名稱 (例如 jQuery123_456、window.foo)， 不合法時改為回傳一般 JSON。
  • lines：前後行數 (before、after) 與行首範圍 (linehead_start 至 linehead_end) 上限為 20000 行，超過時回傳錯誤 (HTTP 400)。最大的單卷約 16500 行，取一整卷不受影響。
  • search/similar：k 參數上限為 5000，超過時回傳錯誤。
  • 加快 textref/data、api/collections、works (依作譯者、朝代、年代、冊號查詢)、 search/title、export/all_creators2、word_seg。

2026-10-10 Version 5.11.2

  • juans/goto：CBETA 未收錄、內容與其他典籍相同的典籍 (例如 X0344 同 T1782)， 改為回傳 HTTP 404 並指出對應的典籍 (原本回傳錯誤)。

2026-10-07 Version 5.11.1

  • API key 說明頁 新增「建議的呼叫頻率」： 建議把流量控制在額度的一半以下、每秒不超過 4 次，以免整個 IP 被伺服器封鎖。

2026-10-03 Version 5.10.0

  • 全文檢索的 order 參數指定了不支援的欄位時，改為回傳錯誤並列出可用的欄位 (原本會忽略該欄位，改用預設排序)。
  • 全文檢索使用括號分組 (例如 ("法鼓" | "印順") "迦葉") 時，改為回傳錯誤。 原本括號會在去除標點時被拿掉，查詢語意因此與輸入不符。

2026-10-03 Version 5.9.6

  • 各 API 說明頁的參數表與回傳範例，改由 OpenAPI 文件 https://cbdata.dila.edu.tw/dev/docs 提供； 說明頁保留概念說明、查詢語法與範例，並連到 API 文件的對應段落。

2026-10-03 Version 5.9.3

  • 目錄：CBETA 收錄部分內容 (選錄) 的佛典，例如 JB214 蕅益大師佛學十種， 不再重複展開對照的佛典清單。

2026-10-01 Version 5.9.1

  • 修正部類目錄：以卷數範圍分會、分卷的典籍節點 (例如大般若經各會)， 缺少結束卷與典籍資訊 (work、category、creators)。
  • search/all_in_one：fields 只列 kwics 時，改為只回傳 kwics。
  • search/all_in_one、search/similar：NEAR 與 Exclude 查詢的部類 facet 補上 category_id。
  • word_seg：缺少 t 參數時回傳文字訊息 (原本回傳整個網頁)。
  • word_seg、word_seg2：斷詞失敗時不再回傳內部錯誤細節；word_seg2 的錯誤補上 code。

2026-10-01 Version 5.9.0

  • 移除兩個從未正常運作的 API：/category/{部類}（一律回傳錯誤）、 依部類查詢請改用各 API 的 category 參數。

2026-09-30 Version 5.8.3

  • 修正 works：以 creator_name 搜尋一律回傳錯誤。
  • 修正 catalog_entry 的 vol 參數、toc 以冊號 (例：T01) 查詢，一律回傳錯誤。
  • 修正查無資料或缺少參數時回傳錯誤 (HTTP 500) 的問題： lines、juans、works/toc，以及 toc 以不存在的經號查詢。
  • Asia Network API (/api/*) 的 uuid 不存在時，改為回傳 HTTP 404。
  • juans/goto 缺少參數時，錯誤碼由 520 改為 400。
  • search/facet 不指定 facet 種類時，依說明頁一次回傳五種 facet。
  • 錯誤回應不再附上程式的 backtrace。
  • 修正多個說明頁的參數說明與範例。

2026-09-30 Version 5.8.2

2026-09-30 Version 5.8.1

2026-09-30 Version 5.7.8

  • 修正 search/all_in_one：fields 參數列了 kwics，但沒有同時列出 work 或 juan 時， 會回傳錯誤。

2026-09-29 Version 5.7.6

  • 配合 CBETA XML 悉漢雙行對照（上行悉曇字、下行漢字）的新標記方式， 調整各種格式的轉檔。
  • 修正下載用純文字檔：悉漢雙行對照的真言，漢字那一行會遺失。
  • 修正全文檢索用的文字：多行的悉漢雙行對照，悉曇字與漢字會混在同一行。
  • 修正線上閱讀的 HTML：悉漢雙行對照的漢字行，文字標記的行號誤標為上一行； 真言之後下一段的行號，有時會被併入真言段落。
  • 修正 KWIC 檢索：行內的悉漢對照，漢字會被移到下一行。

2026-09-22 Version 5.7.2

  • 修正 DOCX、ODT 電子書：註號後文若是悉曇字、蘭札字等特殊字型， 註號在 MS Word 會顯示成空白。

2026-09-18 Version 5.7.1

  • 全文檢索的查詢字串 (q) 長度上限由 80 字降為 40 字，超過會回傳錯誤： https://cbdata.dila.edu.tw/dev/static_pages/search
  • /search/toc 未帶 q 或 q 為空字串時，改為回傳錯誤訊息。
  • 參數錯誤等情況改依錯誤性質回傳對應的 HTTP status（例如 400）， 不再一律回傳 500。/search/kwic、/search/toc 以外的 /search 系列維持原本的回傳方式。
  • /search/kwic 查詢逾時改為回傳 HTTP 504，原本回傳 200 與錯誤訊息。

2026-09-16 Version 5.7.0

  • /search/similar 第一階段取候選時，加入「詞的相鄰程度」重新排序， 真正相似的句子較不會被漏掉。
  • /search/similar 的 k 參數預設值由 2000 改為 1000，速度較快，結果依然完整。
  • /search/similar 同一段經文可能改由相鄰的區塊代表， linehead 與 highlight 的起訖位置會與先前不同，內容相同。

2026-09-15 Version 5.6.1

  • 全文檢索效能改善，/search/variants 異體字建議的回應時間大幅縮短。

2026-09-15 Version 5.6.0

  • DOCX、ODT 全套 zip 內附經號對照表 filelist_季別.txt，格式與 EPUB、PDF 版相同： https://cbdata.dila.edu.tw/dev/static_pages/download_ebooks#docx
  • DOCX、ODT 全套 zip 的最上層資料夾由 docx/、odt/ 改為 cbeta_docx_季別/、cbeta_odt_季別/（例如 cbeta_docx_2026r2/）， 與 EPUB、PDF 的慣例一致。寫死舊資料夾名稱的下載程式需要調整。

2026-09-14 Version 5.5.2

  • 修正 DOCX、ODT 電子書：跨冊佛典（例如 T0220《大般若波羅蜜多經》） 每一卷的內文標題都誤掛上最末冊的卷號範圍。

2026-09-12 Version 5.5.1

  • 修正 /search/notes 使用 Exclude 語法時發生錯誤。

2026-09-12 Version 5.5.0

  • 含 Exclude 語法的全文檢索大幅加速，例如 "菩薩" -"諸菩薩"。

2026-09-11 Version 5.4.0

  • /search/similar 第二階段 Smith-Waterman 比對加速，結果不變。
  • /search/variants 異體字建議加速。

2026-09-11 Version 5.3.0

  • API 存取次數限制改以實際連線的 IP 計算，不再採信 request 自帶的 X-Forwarded-For header。

2026-09-10 Version 5.2.0

  • /search/similar 也改用 Elasticsearch，全文檢索後端全面由 Manticore 改為 Elasticsearch。
  • /search/similar 第一階段取候選的相關度演算法隨之改變， 進入 Smith-Waterman 比對的候選不完全相同，結果順序與筆數與先前略有出入。
  • 修正 /search/similar：比對區域從區塊開頭起算或延伸到區塊結尾時， 原本一律捨棄，程式裡「卷首、卷尾除外」的例外從未生效；現已修正。 （實測 6 個範例查詢共 625 筆命中都沒落在這個情況，實務影響很小。）
  • /search/similar 的 k 參數（第一階段取回的候選筆數）預設由 500 改為 2000， 結果比先前完整；k 必須大於 0，否則回傳 400 錯誤。
  • /search/similar 的結果不再回傳僅供除錯用的 SQL 欄位。

2026-09-10 Version 5.1.0

  • /search/notes 與 /search/title 也改用 Elasticsearch。
  • /search/notes 的 NEAR 語法可以串接多個詞，例如 "老子" NEAR/7 "道" NEAR/3 "經"
  • /search/notes 不支援的查詢語法（括號分組、~n、&）改為回傳 400 錯誤。
  • /search/notes 的 NEAR 查詢不再回傳 total_term_hits，只回傳 num_found。
  • /search/notes 的 NEAR 距離判定改為「兩詞相隔不超過 n 個字」，與說明文件 及 /search/all_in_one、/search/kwic 一致。舊版少算一個字， 因此結果會比舊版略多。
  • /search/notes 的結果不再回傳僅供除錯用的 SQL 欄位。
  • /search/title 新增支援「限制搜尋範圍」的參數（藏經、部類、作譯者、朝代、年代）， 原本傳這些參數會發生錯誤： https://cbdata.dila.edu.tw/dev/static_pages/search_filter
  • /search/title 的相關度排序演算法改變，結果順序與先前不同。
  • /search/variants 多支援 102 個異體字（CJK 擴充 G/H、部首補充、圈號符號等）， 這些字舊版搜尋引擎無法索引，因此以往不會出現在建議清單裡。

2026-09-08 Version 5.0.0

  • Search engine 由 Manticore 改用 Elasticsearch 9.4。
  • 修正 /search 與 /search/extended 的 Extended 語法： 原本查詢字串已含雙引號時語法會失效（例如 q="法鼓" 會被當成「法」AND「鼓」）， 現在正確視為一個詞。/search/all_in_one 不受影響。
  • /search 與 /search/extended 新增支援 NEAR 與 Exclude 語法，詳見： https://cbdata.dila.edu.tw/dev/static_pages/search_extended
  • 排序值相同時，一律再以 藏經、佛典編號、卷號 決定先後，分頁結果因此是穩定的。
  • 不支援的查詢語法（括號分組、~n、&）改為回傳 400 錯誤，不再由搜尋引擎自行解讀。
  • /search/facet 不支援 NEAR 與 Exclude 語法，會回傳 400 錯誤。
  • 搜尋結果不再回傳僅供除錯用的 SQL 欄位。
  • start 參數的上限改為 start + rows 不得超過 100,000。

Version 4.x

2026-09-08 Version 4.8.0

  • 移除 /v1/tools/* 所有 endpoints，以及描述它們的 /openapi.json 與 /docs 文件頁。

2026-09-07 Version 4.7.1

  • 網站各頁加上 API key 的登入入口；產生 key 後可一鍵複製。
  • DOCX、ODT 電子書修正：
    • MS Word 開啟時不再顯示「相容模式」。
    • 西文改用 Times New Roman，不再套用中文字型導致字母間距被撐開。
    • 外文字下方不再出現拼字、文法檢查的波浪線。
    • 字型名稱改為實際字型名稱，不再顯示 cbeta 等簡稱。
    • 註號字級跟著被注的內容，不再被標題段落撐大。
    • 移除「志工轉換」的製作說明，DOCX 已改由本站直接產生。

2026-08-28 Version 4.6.3

  • 修正 DOCX、ODT 電子書：原書 XML 的排版空白不再混入內文 （例如校勘後多出空白、詞句被空白切斷），並移除沒有內容的清單。

2026-08-28 Version 4.6.2

  • DOCX、ODT 電子書補上缺少的樣式定義。

2026-08-22 Version 4.6.1

  • /works 以經號範圍查詢時（work_start、work_end），canon 與經號格式不正確會回傳 400 錯誤， 不再靜默回傳錯誤範圍的資料。

2026-08-21 Version 4.7.0

  • 新增 API key：以 Google 或 GitHub 帳號登入即可申請。目前為過渡期，不帶 key 仍可使用。詳見： https://cbdata.dila.edu.tw/dev/static_pages/api_key
  • API 存取次數限制：未帶 key 每分鐘 60 次（依 IP 計算），帶 key 每分鐘 300 次（依帳號計算）。
  • 流量報表限管理者瀏覽；使用者可在帳號頁查看自己的使用統計。
  • 移除 /mcp endpoint。

2026-08-17 Version 4.6.0

2026-08-17 Version 4.5.0

2026-08-17 Version 4.4.0

  • ODT 電子書改由本站直接產生。

2026-08-17 Version 4.3.0

  • DOCX 電子書改由本站直接產生，原本由志工轉換。

2026-08-13 Version 4.2.0

2026-08-11 Version 4.1.6

  • 目錄 (catalog_entry) 支援指向佛典中特定位置的節點， 例如 T0262《妙法蓮華經》卷7〈觀世音菩薩普門品〉。

2026-08-10 Version 4.1.5

  • /works 的 work 參數接受經號含小寫字母的佛典（例如 Ba001、ZWa073）， 原本部分會被誤判為格式錯誤。

2026-08-10 Version 4.1.4

  • 修正目錄 (catalog_entry) 把部分佛典節點誤判為藏經節點，導致該節點與其下層缺漏。

2026-08-06 Version 4.1.3

  • 修正目錄 (catalog_entry) 漏掉單一佛典的節點，導致查詢下層時 num_found 為 0。

2026-08-03 Version 4.1.2

  • 修正 DOCX 電子書：偈頌中的夾注補上小括號。

2026-07-30

  • 內容更新至 CBETA 2026.R2。

2026-07-16 Version 4.1.1

  • 修正佛典 HTML 中人名、地名標記的位置，遇到標點、空格、缺字或「□」時不再偏移。
  • 新增 API 文件頁 /docs（已於 4.8.0 移除）。

2026-06-30 Version 4.1.0

  • 全文檢索的查詢字串 (q) 長度上限 80 字，超過會回傳錯誤（/search/sc 為 50 字）。
  • 移除舊版 Sphinx 說明頁。
  • 新增 /v1/tools/* 與 /mcp，供 AI 工具查詢 CBETA （/mcp 已於 4.7.0 移除，/v1/tools/* 已於 4.8.0 移除）。
  • /search/variants 異體字建議加速。
  • 修正下載版 HTML 的偈頌對齊，並調整手機版面。

2026-04-27 Version 4.0.0

Version 3.x

2025-12 Version 3.6.3

2025-08 Version 3.5.2

  • 內容更新至 CBETA 2025.R2。

2025-04 Version 3.5.0

  • 內容更新至 CBETA 2025.R1。
  • 「近義詞」加入 教育部《異形詞辨析手冊》所列「異形詞」。
  • 缺字處理 擴大 Unicode 採用範圍。之前是 Unicode 10 以內才採用，現在是有 Unicode 就採用。
  • 下載電子書檔名不含季號，例如 cbeta-epub-2025r1.zip 改為 cbeta-epub.zip
  • 統計報表 新增「新式標點」統計: https://cbdata.dila.edu.tw/dev/report
  • /toc?work=xxx 改為 /works/toc?work=xxx
  • 停用 Sphinx, KWIC3

2024-11 Version 3.4.7

2024-07 Version 3.3.0

  • 內容更新至 CBETA 2024.R2。

2024-06 Version 3.2.0

2024-04 Version 3.0.0

Version 2.x

2023-12 Version 2.2.1

2023-11 Version 2.2.0

  • 內容更新至 CBETA 2023 Q4。

2023-11 Version 2.1.0

  • Sphinx title 搜尋 改為模糊搜尋，至少3個字符合。

2023-08 Version 2.0.0

  • Sphinx 全文 index 分兩套：含夾注、不含夾注 (預設含夾注)。
    • /sphinx/notes: 取消 note_place 參數
    • /sphinx/all_in_one: 新增 note 參數，指定是否含夾注
  • KWIC index 分兩套：含夾注、不含夾注。
    • /kwic3/juan: 新增 note 參數，指定是否含夾注
  • Sphinx、KWIC 不區分大小寫。

Version 1.x

2023-07 Version 1.3.3

  • 內容更新至 CBETA 2023 Q3。
  • new canon: CC

2023-07 Version 1.3.2

  • /juans/goto，回傳欄位 增加 linehead

2023-02 Version 1.3.1

  • 內容更新至 CBETA 2023 Q1。
  • 全文檢索 Sphinx, KWIC 接受 單引號、雙引號、半形減號（須 escape）。

Version 1.3.0

2022-11 Version 1.2.31

  • 存取紀錄若無 Referer，則記錄 IP。
  • Fix bugs: 存取紀錄匯出 CSV

2022-11 Version 1.2.30

  • Referer 來自 *.cn 的屏蔽 TX, Y

2022-10 Version 1.2.29

  • 穩定版網址改為 https://cbdata.dila.edu.tw/stable, 舊網址 https://cbdata.dila.edu.tw/v1.2 將於 2023 Q1 起停用。
  • 內容更新至 CBETA 2022 Q4
  • KWIC 只限單卷。
  • 校注
  • Metadata for TextRef
  • 佛典相關資訊（作譯者、年代等）改由 DILA Authority 取得。
  • 目次回傳資料在允許情況下提供 type 與 n 欄位。
  • 全文檢索
    • Sphinx all_in_one 參數 canon 允許多值。
    • sphinx/variants 異體字查詢，允許參數 scope=title，於經名中存在的才回傳。方便前端提供「搜尋經名」功能時可提供「異體字建議」。
  • 存取紀錄
    • 新增 Referer 欄位，建議呼叫 API 時在 HTTP request header 設定 Referer，以便存取分析。
    • 可匯出 CSV.

2022-07 Version 1.2.28

2022-01 Version 1.2.27

更舊的紀錄

2017-2021