Bible Atlas API

此 API 是公開的、免費的，無需 API 金鑰。Bible Atlas (Bible Atlas) 本身在其網站上使用此 API，並將其作為擴充功能應用於其他平台。此 API 的目標是讓開發者輕鬆獲得與任何聖經經文相關的人物、地點、事件和視覺化內容，並將其嵌入到自己的應用程式中。該 API 設計簡潔直觀，具有清晰的介面和一致的回應，因此您可以利用所需資料來建立任何類型的客戶端應用程式。

閱讀完整的 API 參考文檔嘗試即時請求

每個選擇只能提出一個請求

書卷代碼是三個字母的 USFM 代碼。傳入多個經文編號，即可得到整段選取合併去重後的唯一結果。

GET /api/v1/verse-context?usfm=GEN&chapter=9&verses=8,9

每個實體和視覺化都有自己的頁面連結、卡片圖像和可用於 iframe 的嵌入路徑。

{
  "reference": "Genesis 9:8-9",
  "entities": [
    {
      "type": "event",
      "name": "God makes a covenant with Noah",
      "href": "/god-makes-a-covenant-with-noah",
      "embed": { "path": "/embed/graph/god-makes-a-covenant-with-noah" }
    },
    { "type": "person", "name": "God", "href": "/god" },
    { "type": "person", "name": "Noah", "href": "/noah" }
  ],
  "visualizations": [
    { "label": "Cross references", "href": "/visualizations/cross-references?ref=Gen.9.8" },
    { "label": "The Noahic Covenant", "href": "/visualizations/covenants#covenant-noahic" }
  ]
}

產生卡片

回應中的每個實體和視覺化都包含一個頁面連結和一張圖片，這就是卡片所需的一切。

GET /api/v1/verse-context?usfm=GEN&chapter=9&verses=8,9

<a href="https://bible-atlas.com/noah">
  <img src="https://bible-atlas.com/og/person.png" alt="" />
  <span>Noah</span>
</a>

Noah

The Noahic Covenant

直接嵌入經文

您可以使用 iframe 將任何經文直接嵌入到您的應用程式中。只需將 iframe 指向經文的 URL，Bible Atlas就會顯示該經文的最佳可用嵌入內容。嵌入內容會自動填滿容器的寬度，並包含經文引用、相關實體和視覺化內容。您也可以使用查詢參數自訂嵌入內容，例如： ?theme=dark 深色模式或 ?height=500 設定高度為 500 像素。

GET /embed/verse/{book}/{chapter}/{verse}

<iframe src="https://bible-atlas.com/embed/verse/genesis/9/8"></iframe>

yourapp.com/read/genesis/9

那個iframe，活的。《創世記》9:8最終指向上帝與挪亞聖約的圖表。

命令列

套件 bible-atlas 為腳本與代理程式封裝了 API。它輸出 JSON、不需要金鑰，並可在 Node.js 20 或更新版本上執行。錯誤會以 code: message的形式輸出到 stderr，並傳回非零結束碼。

npx bible-atlas verse GEN 9 8