deerpark
deerpark

Deerpark API

本站提供公開 API，可用來查詢佛經資料、全文搜索、下載經文以及查閱佛學辭典。API 風格類似 CBETA API 的簡化版本。

基本概念

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

All Works — 取回所有佛經

取回所有佛經的 metadata，目前有 4600+ 條。

請求

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

返回示例

[
  {
    "id": "T0001",
    "title": "長阿含經",
    "byline": "後秦 佛陀耶舍共竺佛念譯",
    "juans": [1,2,3,...,22],
    "chars": 198729,
    "alias": "...",   // 可選，短名稱
    "alt": "X0001 ..." // 可選，CBETA 其它編號
  },
  ...
]

Table of Contents — 經典目錄

取回某部經典的目錄。

請求

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

請求示例

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

返回示例

{
  "juans": [
    {
      "file": "T08n0251",
      "lb": "0848c04",
      "juan": 1,
      "title": "第一"
    }
  ],
  "mulu": [
    {
      "indent": 1,
      "title": "般若波羅蜜多心經序",
      "juan": 1,
      "lb": "0848b19"
    }
  ]
}

Article in HTML — 經文 HTML

取回某卷經文的 HTML 版本。不帶卷號的 URL 會自動轉向該經的第一卷。少量經文帶有以 Data URI 形式嵌入的圖片。

請求

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

請求示例

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

返回示例

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

<article>
...
</article>

</html>

Download — 下載 PDF / ePub / MOBI

CBETA 提供了三種格式的文件下載：PDF（適合 A4 打印）、ePub（開放格式，適合 Apple Books 等閱讀器）、MOBI（適合 Kindle）。

請求

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

請求示例

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 部經，無分頁功能。超過 100 個時，請增加搜索詞。

請求

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

請求示例

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

返回示例

{
  "found": 864,
  "works": [
    {
      "search_results": 56,
      "id": "T1509",
      "title": "大智度論",
      "byline": "龍樹菩薩造 後秦 鳩摩羅什譯",
      "juans": [1,2,3,...],
      "chars": 956053
    },
    ...
  ]
}

Full Text Search — 在一部經中搜索

在指定的一部經中搜索，最多返回 100 個結果，按出現順序排序。

請求

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

請求示例

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

返回示例

{
  "found": 6,
  "results": [
    {
      "juan": 69,
      "lb": "0391a15",
      "paragraph": "...<mark>一切有為法</mark>非常非壞..."
    },
    ...
  ]
}

Dictionary Suggest — 佛學辭典搜索建議

佛學辭典內含五部辭典：《陳義孝佛學常見辭彙》、《法相辭典》、《三藏法數》、《丁福保佛學大辭典》、《佛光大辭典》。輸入簡體字會自動轉為繁體。最多返回 50 個結果。

請求

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

請求示例

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

返回示例

[
  "如來藏",
  "如來藏心",
  "如來藏緣起",
  "如來藏性",
  "如來藏經",
  ...
]

Dictionary Lookup — 佛學辭典查詢

精確查詢辭典詞條。搜索詞必須精確匹配，不提供簡繁轉換，建議使用上方 Suggest API 返回的結果作為搜索詞。

請求

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

請求示例

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

返回示例

{
  "word": "如來藏",
  "data": [
    {
      "dictid": 0,
      "dict": "陳義孝佛學常見辭彙",
      "expl": "<p>真如在煩惱中，攝藏如來一切果地上的功德...</p>"
    },
    ...
  ]
}

提示：在 URL 尾部加 ?html 可以得到簡易版網頁。