Bible Go API

Bible Go API is an open source REST API. It contains multiple translations of The Holy Bible, as well as cross-references. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY.

Live Demo

A live demo of this application can be viewed here.

Getting Everything Running

git clone https://www.github.com/rkeplin/bible-go-api
cd bible-go-api
make images
make up

Note: Upon first start, the volume containing the MySQL data may take several seconds to load.

You should then be able to access http://localhost:8084 for the REST API and http://localhost:8082 for the UI (AngularJS).

API Specifications

List of available translations

GET http://localhost:8084/translations
GET http://localhost:8084/translations/[TranslationID]

List of Genres

GET http://localhost:8084/genres
GET http://localhost:8084/genres/[GenreID]

Content

GET http://localhost:8084/books
GET http://localhost:8084/books/[BookID]
GET http://localhost:8084/books/[BookID]/chapters/[ChapterID]
GET http://localhost:8084/books/[BookID]/chapters/[ChapterID]
GET http://localhost:8084/books/[BookID]/chapters/[ChapterID]/[VerseID]

Note: In order to get content for a specific translation, supply translation as a Query Parameter. For example, http://localhost:8084/books/1/chapters/1/1001002?translation=ASV

Cross References

GET http://localhost:8084/verse/[VerseID]/relations 

Search

GET http://localhost:8084/search?query=[Query]
GET http://localhost:8084/searchAggregator?query=[Query]

Related Projects

• Bible Go API
• Bible PHP API
• Bible AngularJS UI
• Bible MariaDB Docker Image

Credits

Data for this application was gathered from the following repositories.

• scrollmaper/bible_database
• honza/bibles