maderesponsively / biblesearch-api-php
biblesearch-api-php 的 Composer 模块
This package is auto-updated.
Last update: 2024-09-21 20:51:20 UTC
README
该仓库是 biblesearch-api-php 库的分支,作为一个 composer 模块。
该库的最新版本始终可以在 https://github.com/americanbible/biblesearch-api-php 找到。
本库旨在通过提供与基于 XML 的 API 直接交互的 PHP 类来简化您使用 BibleSearch API 的开发。您可以直接使用 API(无需这些类),但如果您的应用程序是用 PHP 编写的,您可能会通过使用这些类来节省时间。
API 提供了对 http://bibles.org 的许多功能的访问,包括搜索各种圣经翻译。使用 API 访问圣经的好处包括
- 您不需要在本地存储文本。我们为您存储。
- 您不需要保持本地存储与文本的最新版本同步。同样,我们为此负责。
- 我们负责管理版权使用。有关此问题的详细说明,请参阅下面的 FUMS 部分。
- 使用免费。我们不收取数据访问或任何更新的费用。ABS 是一个非营利组织,我们为整个基督教社区提供这项服务。
API 密钥
要访问 API,您必须是注册的 BibleSearch 用户,并已通过 http://bibles.org/pages/api/signup 上的注册页面激活您的唯一 API 令牌。一旦您拥有 API 令牌,您就可以调用 API 并检索内容。您的 API 令牌是唯一的,因此不要与他人分享,否则您的访问权限可能会被撤销!
API 文档
您可以在 http://bibles.org/pages/api/documentation 找到圣经搜索 API 文档。
FUMS
公平使用管理系统是 ABS 提供免费数据的同时尊重所有版权的方式。我们必须向版权所有者提供使用数据,以确保数据的使用符合我们的协议。我们通过一种极其轻量级的 JavaScript 跟踪机制来完成此操作。为了使用 API,您必须确保在从 API 拉取数据时将 FUMS JavaScript 嵌入您的网页。您可以将 FUMS 和从 API 调用返回的数据本地缓存,但 FUMS 需要在使用缓存数据的任何网页上。
如果您的应用程序不是网站,请联系我们了解正确的 FUMS 使用方法。
有关 FUMS 的工作原理的更多信息,请访问 http://bibles.org/pages/api/documentation/fums。