經文 API 使用說明

快速開始

經文按照「新舊約／英文書卷名稱／三位數章號」存放。這是靜態 JSON 資料，不需要 API 金鑰。

創世記第一章：

https://liaozihzrong.github.io/bible/data/Old_Testament/Genesis/001.json

約翰福音第三章：

https://liaozihzrong.github.io/bible/data/New_Testament/John/003.json

中文名稱與路徑對照

所有 66 卷書名、章數與路徑都收錄在：

https://liaozihzrong.github.io/bible/data/convert_list.json

例如讀取 zh_to_path["約翰福音"]，會得到 New_Testament/John。完整書卷資料則位於 books 陣列。

{
  "name_en": "John",
  "name_zh": "約翰福音",
  "testament": "New_Testament",
  "testament_zh": "新約",
  "chapters": 21,
  "api_path": "New_Testament/John"
}

提供給 AI 讀取

將章節 JSON 公開網址提供給具備網址讀取能力的 AI，即可要求它依原文引用或校正經文，減少書卷、章節與文字對應錯誤。

提示詞範例：

請讀取以下和合本聖經 JSON：
https://liaozihzrong.github.io/bible/data/New_Testament/John/003.json

請以 book_zh、chapter、verses 內的 verse 與 text 為準，
核對我要引用的經文章節，不要自行改寫經文。

章節 JSON 欄位說明

回傳內容範例

{
  "translation": "Chinese_Union_Version_Traditional",
  "testament": "Old_Testament",
  "testament_zh": "舊約",
  "book": "Genesis",
  "book_zh": "創世記",
  "chapter": 1,
  "verse_count": 31,
  "verses": [
    { "verse": 1, "text": "起初，神創造天地。" }
  ]
}

JavaScript 讀取範例

const url = "/bible/data/New_Testament/John/003.json";
const response = await fetch(url);

if (!response.ok) {
  throw new Error(`HTTP ${response.status}`);
}

const chapter = await response.json();
console.log(chapter.book_zh);       // 約翰福音
console.log(chapter.verses[15]);   // 第 16 節

用中文書名組合路徑

const manifest = await fetch("/bible/data/convert_list.json")
  .then((response) => response.json());

const bookPath = manifest.zh_to_path["創世記"];
const chapter = 1;
const filename = `${String(chapter).padStart(3, "0")}.json`;
const url = `/bible/data/${bookPath}/${filename}`;

Python 讀取範例

import requests

url = (
    "https://liaozihzrong.github.io/bible/data/"
    "Old_Testament/Genesis/001.json"
)
response = requests.get(url, timeout=30)
response.raise_for_status()
chapter = response.json()

for verse in chapter["verses"]:
    print(f'{verse["verse"]} {verse["text"]}')