To get started with the API, we offer a high level overview of common workflows in the GitHub repository: https://github.com/faithcomesbyhearing/dbp/blob/develop/doc/STARTING.md
Additionally, we provide a Postman collection containing the API endpoints, organized by function. See the note in Core Concepts about how to install and configure Postman. In this section, we will refer to the Postman Collection called “Example Workflows”, available here.
Once you have the “Example Workflows” collection configured, you’ll see a series of folders:
- General information on Languages, Countries, Alphabets, Bible books
- How to find the right Bible (and accompanying Filesets)
- Once I have a Bible/Fileset, how do I access content?
Each folder contains requests which can assist you in planning your application.
For example, the General Information folder can provide information on Languages available in a Country or translations available for a Bible. There are also endpoints to provide information on alphabets and numeral systems.
The next folder, How to find the right Bible (and accompanying Filesets), provides a set of filters for language code, content type (eg text, audio, video). It also provides general information on Bible book order, publisher information, and specifics about what content types are available for a particular Bible. Once you narrow your search, the key to retrieving content is the Fileset identifier. Review the Core Concepts page for details on how to work with the Fileset id.
The third folder contains requests necessary for retrieving Bible content and required copyright information. You will notice that almost all content can be retrieved from a single endpoint, as long as you know the FilesetId.
The final folder contains an endpoint for retrieving the OpenAPI 3.0 definition of the Bible Brain API. This is used to generate the reference documentation. But if you would like to use a different OpenAPI-compliant tool, the endpoint will provide an up-to-date version of the definition in json format.
Questions to ask as you design your application:
Unfortunately, Internet Explorer is an outdated browser and we do not currently support it. To have the best browsing experience, please upgrade to Microsoft Edge, Google Chrome or Safari.