# 漢文大藏經 API（CBETA 鏡像）

> 以 CBETA 電子佛典為底本的唯讀 HTTP API，介面與 deerpark.app 相容。基底網址：https://deerpark.qitaijia.com
> 所有端點為 GET、無需驗證、允許跨來源（CORS *），錯誤回 JSON {"error": "..."}。

## 端點

- /api/search/title?q=&limit= — 經名檢索：經號、經名、別名、譯者、簡體輸入、拼音全拼與首字母（如 jgj）。limit ≤ 50。
  例：https://deerpark.qitaijia.com/api/search/title?q=金刚经
- /api/v1/allworks — 全部收錄全文的經典清單（id、title、byline、juans、chars）。
  例：https://deerpark.qitaijia.com/api/v1/allworks
- /api/v1/work/:id — 經典資訊：作譯者、卷別更新日期、導讀、各類網址；目錄條目回 hosted:false。
  例：https://deerpark.qitaijia.com/api/v1/work/T0235
- /api/v1/toc/:id — 卷目與品目（mulu），含行號 lb。
  例：https://deerpark.qitaijia.com/api/v1/toc/T0262
- /api/v1/text/:id/:juan — 單卷經文 Markdown；省略卷號則 302 至首卷。
  例：https://deerpark.qitaijia.com/api/v1/text/T0235/1
- /api/v1/html/:id/:juan — 單卷經文 HTML（含行號錨點、夾注、缺字標記）；省略卷號則 302 至首卷。
  例：https://deerpark.qitaijia.com/api/v1/html/T0235/1
- /api/v1/download/:type/:id — 302 轉至 CBETA 官方下載（type：pdf、epub、mobi）。
  例：https://deerpark.qitaijia.com/api/v1/download/pdf/T0235
- /api/v1/fts/works/:term?limit= — 全文檢索：依命中數排序的經典。limit ≤ 100；逾時回 timedOut:true。
  例：https://deerpark.qitaijia.com/api/v1/fts/works/應無所住
- /api/v1/fts/:id/:term?limit= — 單經全文檢索：卷、精確行號 lb、含 <mark> 的上下文。limit ≤ 100。
  例：https://deerpark.qitaijia.com/api/v1/fts/T0235/應無所住
- /api/search/fulltext?q=&limit=&offset= — 全文檢索（片段）：total 計至 500，超過時 totalCapped:true。limit ≤ 50。
  例：https://deerpark.qitaijia.com/api/search/fulltext?q=应无所住而生其心
- /api/v1/dict/suggest/:term — 佛學辭典詞條建議（≤ 50）。
  例：https://deerpark.qitaijia.com/api/v1/dict/suggest/如來
- /api/v1/dict/lookup/:term — 佛學辭典查詢；加 ?html 回傳簡易網頁。
  例：https://deerpark.qitaijia.com/api/v1/dict/lookup/如來藏
- /api/stories — 經典故事（AI 衍生，附 provenance）。參數：search、category、work_id、tag、page、limit ≤ 100；另有 /random、/:id。
  例：https://deerpark.qitaijia.com/api/stories?work_id=cbeta:T0235&limit=10
- /api/highlights — 經文精華（AI 衍生，附 provenance）。參數同上；另有 /random、/:id。
  例：https://deerpark.qitaijia.com/api/highlights?work_id=cbeta:T0235
- /api/v1/categories — （本站擴充）部類清單：name、workCount、juanCount，只計收錄全文的經典；依大正藏部類次序，其餘依部數。
  例：https://deerpark.qitaijia.com/api/v1/categories
- /api/v1/category/:name?page=&limit= — （本站擴充）某部類的經典（依經號排序，分頁；limit ≤ 100）。未知部類回 404 Category not found。
  例：https://deerpark.qitaijia.com/api/v1/category/般若部?page=1&limit=50
- /api/health — 服務與資料庫狀態。
  例：https://deerpark.qitaijia.com/api/health
- /api/version — 目前 CBETA 版本、資料 schema 與啟用時間。
  例：https://deerpark.qitaijia.com/api/version
- /cbeta/:id[/:juan] — 302 轉至 CBETA Online 閱讀頁。
  例：https://deerpark.qitaijia.com/cbeta/T0262/2

擴充端點：標示「本站擴充」者為本鏡像新增、deerpark.app 沒有的端點（/api/v1/categories、/api/v1/category/:name）。

## 用法提示

- 經號格式為 CBETA 編號（如 T0235、X1001、JB427）；書名檢索回傳的 id 前綴為 "cbeta:"。
- 全文檢索會先做簡轉繁、去除標點與空白，因此「应无所住」與「應無所住，」等價。
- 2 字詞檢索可能較慢；逾時時回 200 並帶 timedOut:true（結果可能不完整）。
- 請合理快取：經典清單 24 小時、經文 1 小時、檢索 5 分鐘（見 Cache-Control 與 ETag）。

## 來源與授權

- 經文、目錄與行號來自 CBETA 中華電子佛典協會（https://www.cbeta.org/），依 CC BY-NC-SA 3.0 授權（https://creativecommons.org/licenses/by-nc-sa/3.0/）。轉載請標示「CBETA 電子佛典」及版本（見 /api/version），不得作商業用途，衍生作品須以相同方式分享。
- 經名辭典資料來自其各自出處，依原授權使用。

## AI 衍生內容聲明

- /api/stories、/api/highlights 及經典導讀（work 的 summary、juanSummaries）由大型語言模型依經文生成，僅供參考，可能有誤；每筆皆附 provenance（模型、提示詞版本）。引用經文請以 /api/v1/text 或 /api/v1/html 的 CBETA 原文為準。
- /api/v1/text、/api/v1/html 只含 CBETA 原文，不含任何 AI 生成內容。