biblesearch/api-php

此包已弃用且不再维护。未建议替代包。

biblesearch-api-php 的 Composer 模块

dev-master 2016-03-24 16:06 UTC

This package is auto-updated.

Last update: 2023-04-28 23:29:32 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 访问圣经的好处包括

  1. 您不需要本地存储文本。我们为您存储。
  2. 您不需要保持本地存储与文本的最新版本同步。同样,我们为您完成这项工作。
  3. 我们负责管理版权使用。有关此内容的详细说明,请参阅以下标题为 FUMS 的部分。
  4. 使用免费。我们不收取数据访问或任何更新的费用。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