README

这是一个开源的API，返回JSON格式的经文序列，可用于任何编程语言。例如，已创建一个Wordpress插件，可以帮助您只需使用短代码即可在页面上插入圣经文本。

[Biblia pasaj="Geneza 1:1-10"]

我很快就会公开这个Wordpress插件，但它还需要进行一些测试。

如何进行查询

Bible Api使用ichthus-soft/bible_ref包来理解您希望返回的查询。因此，您有以下选项

作者注：在下面的示例中，您会看到您可以像使用空格一样使用+。这样，URL看起来会比使用空格更美观。这完全取决于个人喜好，API也理解使用空格和+的查询。

# Un singur verset
Ioan 3:16 sau Ioan+3:16
# Un pasaj de versete
Ioan 3:1-16 sau Ioan+3:1-16
# Mai multe capitole
Ioan 3:1&4:1-10
# Poti cere mai multe carti
Ioan 3:16;Filipeni 1:12
# Poti combina toate acestea
Ioan 3:16&1:1;Apocalipsa 1:1-10,15;Geneza 1:1-20&2:1

因此，为了概括

格式是书名卷:节[结束]
要添加新章节，在查询中添加& - 2:1&3:5
要添加新书籍，在查询中添加; - 创世记 1:1;使徒行传 1:9

API返回什么？

如果您熟悉JSON，可以查看下面的响应示例。API返回以下内容：

段落 - 显示经文的段落
经文 - 一个数组，其中包含以下字段：testament - 1是OT，2是NT，book - 书名，chapter - 节所在的章节，verse - 节的编号，text - 文本，即经文本身。
text - 所有经文连接在一起，形成一个单独的文本块
nl - 经文之间有<br>间隔
nlvn - 经文之间有<br>间隔，并且每行开始处有节号

在经文中，耶稣所说的话位于具有.Isus类的span中。因此，您可以通过CSS为这些词着色或为它们提供特殊样式，而不同于其他文本。

每日经文 在此API中，您还可以使用来自Resursecrestine.ro的API来访问每日经文。您只需访问biblia.filipac.net/v2/versetulZilei，就会收到与文档末尾相同的标准化响应。

如何帮助这个项目？

您可以从许多方式帮助，我只列举其中一些

测试此产品，看看是否可以找到bug，并在GitHub上报告，或者尝试自己解决（为此项目创建一个分支，解决，提交并然后提出请求）
向朋友宣传这个项目。
在自己的网站上使用此API（例如，bisericasega.ro经常使用此API）
提供改进的想法 - 总是可以添加新功能或改进现有功能。
编写更详细的文档！ 我（菲利普）不太愿意写文档。你可以自己来做。
在您的网站上安装API。

以下是我现在能想起的一些。

我如何在网站上安装这个API呢？

您不必一定要安装这个API，您也可以放心地使用我的服务器。不过，如果您认为您通过每分钟数千次的访问可能会减慢我的服务器速度，您可以在自己的服务器上安装它。您需要的是 Apache，PHP 5.5，Composer 和 Mysql。步骤如下

方法1

从GitHub克隆此项目： git clone https://github.com/ichthus-soft/bible-api
使用Composer安装项目 - composer install

方法2

使用Composer安装项目： composer require ichtus-soft/bible-api。

配置

将 config.php.dist 复制到一个名为 config.php 的文件中，并更改数据库访问数据。
访问服务器的公开URL，并按照屏幕上的步骤插入Mysql中需要的表格。
完成！您已本地安装了API。现在您可以使用自己的URL而不是 biblia.filipac.net。

如果您没有本地安装Apache：对于开发，您可以使用内部PHP服务器。您需要做的就是打开项目安装目录下的终端，并输入以下命令： php -S localhost:80。然后您可以通过 https:// 访问，您将看到您的新项目正在运行。为此，您需要PHP版本大于5.4。

查询和响应示例

http://biblia.filipac.net/v2/Ioan+3:16&1:1

{
pasaj: "Ioan 3:16,1:1",
versete: [
{
testament: "2",
carte: "Ioan",
capitol: "3",
verset: "16",
text: "<span class='Isus'>Fiindcă atât de mult a iubit Dumnezeu lumea, că a dat pe singurul Lui Fiu, pentru ca oricine crede în El să nu piară, ci să aibă viaţa veşnică.</span>"
},
{
testament: "2",
carte: "Ioan",
capitol: "1",
verset: "1",
text: "La început era Cuvântul, şi Cuvântul era cu Dumnezeu, şi Cuvântul era Dumnezeu."
}
],
text: "<span class='Isus'>Fiindcă atât de mult a iubit Dumnezeu lumea, că a dat pe singurul Lui Fiu, pentru ca oricine crede în El să nu piară, ci să aibă viaţa veşnică.</span> La început era Cuvântul, şi Cuvântul era cu Dumnezeu, şi Cuvântul era Dumnezeu. ",
nl: "<span class='Isus'>Fiindcă atât de mult a iubit Dumnezeu lumea, că a dat pe singurul Lui Fiu, pentru ca oricine crede în El să nu piară, ci să aibă viaţa veşnică.</span><br>La început era Cuvântul, şi Cuvântul era cu Dumnezeu, şi Cuvântul era Dumnezeu.<br>",
nlvn: "<span style="font-size: 10px;">16</span> <span class='Isus'>Fiindcă atât de mult a iubit Dumnezeu lumea, că a dat pe singurul Lui Fiu, pentru ca oricine crede în El să nu piară, ci să aibă viaţa veşnică.</span><br><span style="font-size: 10px;">1</span> La început era Cuvântul, şi Cuvântul era cu Dumnezeu, şi Cuvântul era Dumnezeu.<br>"
}

已知使用此API的网站

www.bisericasega.ro

ichthus-soft / bible-api

维护者

详细信息