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