# 安提阿圣经 API

> 网站：https://bible.jeshurun.top 。通过公开 GET API 获取真实经文；引用时注明书卷、章、节和译本。无需登录或 API Key。

## 文档

- [OpenAPI 描述](https://bible.jeshurun.top/openapi.json)：可供支持 OpenAPI 的客户端导入。
- [网站](https://bible.jeshurun.top/)：圣经阅读应用。

## 获取经文

API 基址：https://bible.jeshurun.top

指定节：GET /api/bible/verses?bookNum=43&chNum=3&verseNums=16,17,18&versions=ckjv2&format=plain
整章：GET /api/bible?bookNum=43&chNum=3&versions=ckjv2&format=plain
搜索：GET /api/bible/search?query=耶稣&versions=ckjv2&books=43&exact=true

- bookNum：书卷编号 1–66，见下表。
- chNum：章号，正整数。
- verseNums：同一章内的节号，逗号分隔，最多 200 项。例如 16,17,18；不接受 16-18。跨章引用需要分别请求。
- versions：逗号分隔的译本代码；获取经文时默认 ckjv2，多译本按请求顺序返回。
- format=plain：返回可直接引用的纯文本，移除人名、地名的 <ref> 标签，保留标签中的名字。省略该参数时保留原有标记。
- useOldNames=true：仅对 ckjv3 将标记中的人名、地名改为传统译名；可以与 format=plain 一起使用，先替换译名再去标签。

译本：ckjv2 = 钦定本圣经；ckjv3 = 公认文本圣经；cuv = 和合本圣经；kjv = 英文 KJV Bible。

## 批量读取

- 同一章多节（最多 200 项）：GET /api/bible/verses?bookNum=43&chNum=3&verseNums=16,17,18&versions=ckjv2&format=plain
- 同一章多节、多译本：GET /api/bible/verses?bookNum=43&chNum=3&verseNums=16,17,18&versions=ckjv2,kjv&format=plain
- 一整章、多译本：GET /api/bible?bookNum=43&chNum=3&versions=ckjv2,kjv&format=plain
- 跨书卷或跨章批量引用：按 (bookNum, chNum) 分组，将各组节号去重后用 verseNums 一次请求；每组超过 200 项时拆分请求。批量整章则每章请求一次。
- 例如“约翰福音 3:16–18 和罗马书 8:1–2”：分别请求 bookNum=43&chNum=3&verseNums=16,17,18 与 bookNum=45&chNum=8&verseNums=1,2，并附上所需 versions 和 format=plain。
- 节范围要展开成逗号分隔列表；接口不接受跨章的 verseNums，也没有单次跨章批量端点。
- 汇总时使用 (version, book_num, ch_num, verse_num) 区分经文，保留每次响应的缺失节信息。

## 响应与引用

两个经文接口返回 JSON：{"verses":{"16":[经文记录],"17":[经文记录]}}。
经文记录字段：word_id、word（经文正文）、book_num、ch_num、verse_num、version、version_zh（简称：钦、公、和、kjv）。
指定节接口还返回 missingVerseNums。参数无效返回 400；全部不存在返回 404；部分不存在时返回 200 并列出缺失节号。
missingVerseNums 表示所有请求译本中都不存在的节号；需要某个特定译本时还应检查该节数组的 version。
整章接口未传 bookNum/chNum 时默认 1/1，查不到经文时返回空 verses。数据库查询失败返回 500。
只引用响应中实际存在的 word，并注明完整译本名。不要根据节号自行补写缺失内容。
例如引用标签写作“约翰福音 3:16（钦定本圣经）”；引用多个译本时分别标明译本。

搜索参数：query（必填，URL 编码）、versions（不传则搜索所有译本）、books（逗号分隔书卷编号）、exact=true（连续短语匹配；默认 false）。
搜索响应为 {"results":[经文记录]}，word 已去除 <ref> 标记，可直接引用；_formatted.word 带有 <strong> 高亮标签，供网页展示。
搜索结果数量受服务器 SEARCH_LIMIT 控制，默认最多 200 条，没有分页；搜索命中后可用指定节 API 获取上下文。

## 书卷编号

| bookNum | 中文书卷 | English | 章数 |
| --- | --- | --- | --- |
| 1 | 创世记 | Genesis | 50 |
| 2 | 出埃及记 | Exodus | 40 |
| 3 | 利未记 | Leviticus | 27 |
| 4 | 民数记 | Numbers | 36 |
| 5 | 申命记 | Deuteronomy | 34 |
| 6 | 约书亚记 | Joshua | 24 |
| 7 | 士师记 | Judges | 21 |
| 8 | 路得记 | Ruth | 4 |
| 9 | 撒母耳记上 | 1 Samuel | 31 |
| 10 | 撒母耳记下 | 2 Samuel | 24 |
| 11 | 列王纪上 | 1 Kings | 22 |
| 12 | 列王纪下 | 2 Kings | 25 |
| 13 | 历代志上 | 1 Chronicles | 29 |
| 14 | 历代志下 | 2 Chronicles | 36 |
| 15 | 以斯拉记 | Ezra | 10 |
| 16 | 尼希米记 | Nehemiah | 13 |
| 17 | 以斯帖记 | Esther | 10 |
| 18 | 约伯记 | Job | 42 |
| 19 | 诗篇 | Psalms | 150 |
| 20 | 箴言 | Proverbs | 31 |
| 21 | 传道书 | Ecclesiastes | 12 |
| 22 | 雅歌 | Song of Solomon | 8 |
| 23 | 以赛亚书 | Isaiah | 66 |
| 24 | 耶利米书 | Jeremiah | 52 |
| 25 | 耶利米哀歌 | Lamentations | 5 |
| 26 | 以西结书 | Ezekiel | 48 |
| 27 | 但以理书 | Daniel | 12 |
| 28 | 何西阿书 | Hosea | 14 |
| 29 | 约珥书 | Joel | 3 |
| 30 | 阿摩司书 | Amos | 9 |
| 31 | 俄巴底亚书 | Obadiah | 1 |
| 32 | 约拿书 | Jonah | 4 |
| 33 | 弥迦书 | Micah | 7 |
| 34 | 那鸿书 | Nahum | 3 |
| 35 | 哈巴谷书 | Habakkuk | 3 |
| 36 | 西番雅书 | Zephaniah | 3 |
| 37 | 哈该书 | Haggai | 2 |
| 38 | 撒迦利亚书 | Zechariah | 14 |
| 39 | 玛拉基书 | Malachi | 4 |
| 40 | 马太福音 | Matthew | 28 |
| 41 | 马可福音 | Mark | 16 |
| 42 | 路加福音 | Luke | 24 |
| 43 | 约翰福音 | John | 21 |
| 44 | 使徒行传 | Acts | 28 |
| 45 | 罗马书 | Romans | 16 |
| 46 | 哥林多前书 | 1 Corinthians | 16 |
| 47 | 哥林多后书 | 2 Corinthians | 13 |
| 48 | 加拉太书 | Galatians | 6 |
| 49 | 以弗所书 | Ephesians | 6 |
| 50 | 腓立比书 | Philippians | 4 |
| 51 | 歌罗西书 | Colossians | 4 |
| 52 | 帖撒罗尼迦前书 | 1 Thessalonians | 5 |
| 53 | 帖撒罗尼迦后书 | 2 Thessalonians | 3 |
| 54 | 提摩太前书 | 1 Timothy | 6 |
| 55 | 提摩太后书 | 2 Timothy | 4 |
| 56 | 提多书 | Titus | 3 |
| 57 | 腓利门书 | Philemon | 1 |
| 58 | 希伯来书 | Hebrews | 13 |
| 59 | 雅各书 | James | 5 |
| 60 | 彼得前书 | 1 Peter | 5 |
| 61 | 彼得后书 | 2 Peter | 3 |
| 62 | 约翰一书 | 1 John | 5 |
| 63 | 约翰二书 | 2 John | 1 |
| 64 | 约翰三书 | 3 John | 1 |
| 65 | 犹大书 | Jude | 1 |
| 66 | 启示录 | Revelation | 22 |