Skip to content
Permalink
master
Switch branches/tags
Go to file
 
 
Cannot retrieve contributors at this time

API for Chinese Tripitaka (deerpark.app)

CBETA version

「漢文大藏經」網站目前是由一個人在開發和維護,進度不會太快,有任何建議或意見請發到 brian@xmind.net 。謝謝支持!🙏

服務器目前放在 AWS Tokyo,運營成本由「XMind 軟件公司」供養。🙏

概念

本站的 API 看起來會像是 CBETA API 的一個簡化版本。

以下是一些概念:

  • work:一部經或一部論,有的很長有600卷,有的只有一卷。
  • juan:一卷。也就是一個 html 文件。
  • lb:行號。在 html 文件中,會以 <span class="lineInfo" line="0106c09"></span> 的形式出現,一般只在每一段的開頭。

All works

取回所有佛經的 meta data,目前有 4600+ 條。

API:

GET https://deerpark.app/api/v1/allworks

Sample Response:

除了 alias/alt 之外,其它信息是一定會有的。

[
  {
    "id": "T0001", // 在 CBETA 中的編號,前一個或兩個字母表示藏經,具體可查閱 CBETA 文檔
    "title": "長阿含經",
    "byline": "後秦 佛陀耶舍共竺佛念譯", // 譯者或作者,有些是一人,有些是多人,有些是(失)
    "juans": [1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22], // 大部分經是從1開始,有時候不是
    "chars": 198729, // 祛除標點符號後的字數

    // Optional
    "alias": "...", // 短名稱。大部分經沒有,少數有,如「法華經」
    "alt": "X0001 xxxxxx" // CBETA 其它編號和名稱。大部分經沒有,少數有,詳見 JB277。App 中不予以顯示。
  },
  ...
]

Table of Contents

取回某部經典的目錄

API:

GET https://deerpark.app/api/v1/toc/:id

Sample Request:

GET https://deerpark.app/api/v1/toc/T0251

Sample Response:

{ // 返回兩個部分
  "juans": [ // 第一部分是分卷
    {
      "file": "T08n0251", // 用不上
      "lb": "0848c04",
      "juan": 1,
      "title": "第一"
    }
  ],
  "mulu": [ //第二部分是目錄
    {
      "indent": 1, // 縮進,1表示第一級,沒有0
      "title": "大明太祖高皇帝御製序",
      "juan": 1,
      "lb": "0848a03" // 行號
    },
    {
      "indent": 1,
      "title": "般若波羅蜜多心經序",
      "juan": 1,
      "lb": "0848b19"
    }
  ]
}

Article in html

取回某卷經文的 html 版本。其中有少量的經文帶圖片,圖片是以 Data URI 的形式放在 html 裡的。

API:

不帶卷號的 url 會自動轉向為該經的第一卷,如果沒有第一卷就往後遞推。

GET https://deerpark.app/api/v1/html/:id
GET https://deerpark.app/api/v1/html/:id/:juan

Sample Request:

GET https://deerpark.app/api/v1/html/T0251
GET https://deerpark.app/api/v1/html/T0251/1

Sample Response:

<!doctype html>
<html lang="zh-TW">
<meta charset=utf-8>
...
<title>般若波羅蜜多心經</title>

<article>
...
</article>

</html>

Download pdf/epub/mobi

最新更新:pdf/epub/mobi 已全部更新為最新版。今後應該能與 html 保持版本一致。

API:

GET https://deerpark.app/api/v1/download/:type/:id

CBETA 提供了三種格式的文件下載,分別是:

  • PDF (適合 A4 面幅打印)
  • epub (開放格式,適合所有 epub 閱讀器,如 Apple Books)
  • mobi (適合 Kindle 閱讀)

Sample Request:

GET https://deerpark.app/api/v1/download/pdf/T0945
GET https://deerpark.app/api/v1/download/epub/T0945
GET https://deerpark.app/api/v1/download/mobi/T0945

Full Text Search (在所有經中搜索)

搜索結果最多返回 100 個 works,無分頁功能,所以超過 100 個時,請增加搜索詞。

API:

GET https://deerpark.app/api/v1/fts/works/:term

Sample Request:

GET https://deerpark.app/api/v1/fts/works/一切有为法

Sample Response:

請注意,這裡沒有返回上下文,只返回了該關鍵詞在每部經中出現多少次。按次數排序。

{
  "found": 864, // 一共有多少結果,單位是「處」而不是「經」
  "works": [ // 出現次數最多的 100 部經
    {
      "search_results": 56, // 關鍵詞在本經出現的次數

      // 以下是本經的基本信息
      "id": "T1509",
      "title": "大智度論",
      "byline": "龍樹菩薩造 後秦 鳩摩羅什譯",
      "juans": [1,2,3,4,5,6,7,8,9,10......],
      "chars": 956053
    },
    ...
  ]
}

Full Text Search (在一部經中搜索)

搜索結果最多返回 100 個 results,無分頁功能,所以超過 100 個時,請增加搜索詞。

API:

GET https://deerpark.app/api/v1/fts/:id/:term

Sample Request:

https://deerpark.app/api/v1/fts/T0220/一切有为法

Sample Response:

{
  "found": 6, // 一共有多少結果
  "results": [ // 最多 100 個結果,按出現順序排序
    {
      "juan": 69, // 第幾卷
      "lb": "0391a15", // 行號
      "paragraph": "...非壞。何以故?本性爾故。一切有漏法非常非壞。何以故?本性爾故。一切無漏法非常非壞。何以故?本性爾故。<mark>一切有為法</mark>非常非壞。何以故?本性爾故。一切無為法非常非壞。何以故?本性爾故。舍利子!由此緣故我作是說:諸法亦爾..." // 上下文,關鍵詞用 <mark> 標出,無其它 html tag
    },
    ...
  ]
}

Reading lists

API:

GET https://deerpark.app/api/v1/readinglist/:name

目前已有 4 個 reading list,分別是:

  • 首頁常用經典(home)
  • 更多常用經典(famous)
  • 福嚴精舍三年閱經目錄(fuyan)
  • 印順法師佛學著作集(yinshun)

閱讀列表有兩種格式:

  1. 一種是數組,數組中的每個元素是一條數據。多數列表是這種格式。
{ "items": [...] }
  1. 另一種是分 category,每個 category 是一個數組。目前只有「福嚴精舍三年閱經目錄」是這種格式。
{ 
  "items": [
    { 
      "title":"第一年·甲",
      "type": "category",
      "items":[...]
    },
    ...
  ]
}

單條數據有三種格式:

  1. 整部經典。跟 allworks 中的格式一樣。
{
  "id": "T0784",
  "title": "四十二章經",
  "byline": "後漢 迦葉摩騰共法蘭譯",
  "juans": [1],
  "chars": 2495
}
  1. 某部經典中的一部分。
{
  "special": true,
  "title": "華嚴經 十地品",
  "byline": [ // 不同於其它地方,這裡的 byline 是個數組
    "大方廣佛華嚴經 (八十華嚴)",
    "唐 實叉難陀譯",
    "CBETA T0279",
    "第34~39卷"
  ],
  "target": "T0279/34"
}
  1. 外部網站連結。
{
  "special": true,
  "external": true,
  "title": "學佛行儀",
  "byline": "善因法師述 | 外部網站",
  "target": "https://jnbooks.cn/search/學佛行儀"
}

Sample Request:

GET https://deerpark.app/api/v1/readinglist/home
GET https://deerpark.app/api/v1/readinglist/famous
GET https://deerpark.app/api/v1/readinglist/fuyan
GET https://deerpark.app/api/v1/readinglist/yinshun

Sample Response (home):

{
  "items": [
    {
      "id": "T0784",
      "title": "四十二章經",
      "byline": "後漢 迦葉摩騰共法蘭譯",
      "juans": [1],
      "juan": 1,
      "chars": 2495
    },
    ...
  ]
}

API for Buddhist Dictionary

新增佛學辭典 API,內含五部辭典,分別是《陳義孝佛學常見辭彙》,《法相辭典》,《三藏法數》,《丁福保佛學大辭典》,《佛光大辭典》。

Search Suggestion

API:

GET https://deerpark.app/api/v1/dict/suggest/:term

Sample Request:

如果用戶輸入的是簡體字,API 會自動轉為繁體。如果該簡體對應多個繁體,我們會盡量保證多個版本都有效。

GET https://deerpark.app/api/v1/dict/suggest/如來藏

最好在請求的關鍵詞中,只出現中文,不出現西文字符。 (Best Practice)

Sample Response:

首先出現在結果中的,是和關鍵詞一模一樣的詞條,其次是以關鍵詞為首的詞條,最後是包含關鍵詞的詞條。最多返回 50 個結果。

[
  "如來藏",
  "如來藏心",
  "如來藏緣起",
  "如來藏性",
  "如來藏經",
  "如來藏經十喻",
  "如來藏論",
  "一切有情是如來藏等",
  "三如來藏",
  "不空如來藏",
  "九喻──如來藏九喻",
  "二如來藏",
  "空如來藏",
  "大方廣如來藏經",
  "大方等如來藏經",
  "十種如來藏",
  "隱沒如來藏"
]

Lookup

API:

GET https://deerpark.app/api/v1/dict/lookup/:term

(PS. 在尾部加 ?html 可以得到簡易版網頁)

Sample Request:

注意:搜索詞必須是精確的,否則會 404。這裡不提供簡繁轉換。所以最好使用上面 Search Suggestion API 提供的結果。

GET https://deerpark.app/api/v1/dict/lookup/如來藏

Sample Response:

{
    "word": "如來藏", // 搜索詞
    "data": [ // 不超過 5 個結果,因為只有五部辭典,請勿依賴其順序
        {
            "dictid": 0,
            "dict": "陳義孝佛學常見辭彙", // 辭典名稱
            "expl": "<p>真如在煩惱中,攝藏如來一切果地上的功德,名如來藏,若出了煩惱,即名法身。</p>"
        },
        ...
    ]
}

如果 dictid = 3 (丁福保佛學大辭典),expl 可能會出現 hyperlink,例如:

  • <a href="/dict/如來藏">如來藏</a>