CBETA API 5.11.3

DILA 2016/2026

請先登入

更新紀錄

目次

Version 5.x

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