Page 1 of 1

Book of Mormon API

Posted: Wed Oct 07, 2015 12:12 am
by donjuanica
I thought I'd share this with the group. I've seen a lot of posts about an open BoM API for use in web/mobile apps. I put together a quick NodeJS + Express + MongoDB API that will give you access to the BoM verses. I imported the data from the Book of Mormon found in the Gutenberg Library.

For now this is running in RedHat openshift on the free tier. If it gets too much traffic I suppose they'll contact me and complain, but for now I'd appreciate any testing/feedback.

You can access the API at:

http://bomapi-happycloud.rhcloud.com/v1/verses

The root URL will return 100 verses from the BoM but you can specify any granularity you want (all other endpoints will return a max of 10 verses):

http://bomapi-happycloud.rhcloud.com/v1 ... ter/:verse

e.g.

http://bomapi-happycloud.rhcloud.com/v1/verses/Moroni
http://bomapi-happycloud.rhcloud.com/v1 ... /Moroni/10
http://bomapi-happycloud.rhcloud.com/v1 ... oroni/10/4

Have fun.

Re: Book of Mormon API

Posted: Thu Oct 08, 2015 2:31 pm
by samtwarnick
This looks great! Is there any way to request multiple verses at once ( i.e. http://bomapi-happycloud.rhcloud.com/v1 ... oni/10/3-5 ) or get all verses in a chapter? Thanks

Re: Book of Mormon API

Posted: Sat Oct 10, 2015 1:33 pm
by donjuanica
You can get multiple verses by leaving off the last segment of the API path. Right now the API limits to returning a max of 10 verses, but I may remove that restriction at some point.

To get up to 10 verses from Moroni 10 you would use:

/v1/verses/Moroni/10

To get the first 10 verses of Moroni You would use:

/v1/verses/Moroni

I kind of like your idea to specify a range of verses as the last part of the path:

/v1/verses/Moroni/10/3-5 - right now that doesn't work but I think I'll add support for it.

Thanks

Re: Book of Mormon API

Posted: Sat Oct 10, 2015 2:05 pm
by donjuanica
I added the ability to specify ranges of verses:

/v1/verses/Moroni/10/3/5 would give you Moroni 10:3-5

So instead of passing a range as the final path param, you add an additional path param to define the range:

/v1/verses/:book/:chapter/:start_verse/:end_verse

HTH

Re: Book of Mormon API

Posted: Tue Oct 20, 2015 5:48 pm
by samtwarnick
Just saw that you updated this. Thanks for adding the ability to get more than one verse. I'll play around with it some more.

Re: Book of Mormon API

Posted: Sun Jan 29, 2017 2:42 pm
by bartoleria
Nice, great job!

Are you maintaining the project? Do you plan to keep working on it?

Re: Book of Mormon API

Posted: Sun Aug 27, 2017 5:35 pm
by dancej
Are you still maintaining this? Looks cool and I would like to use it.

Re: Book of Mormon API

Posted: Sun Sep 17, 2017 9:05 pm
by mattalui
Wow! This is great!

How exactly to we request information from books like Nephi with multiple books?