The Lifechurch.tv API Ruby Gem
A Ruby wrapper for the Lifechurch.tv REST API
Installation
gem install lc_api
Quick Start Guide
First, register your application with LifeChurch.tv at http://api.lifechurch.tv.
Then, copy and paste in your API Key.
LcApi.key = "K690FKW924CKUCJTH94WK294WK029834SDFJ9862KSDF9234SDKF9421KDVDS"
Try finding a single resource:
msg = LcApi::Message.find(1)
Try finding multiple resources:
msg = LcApi::Message.find(:all)
Filter results:
msg = LcApi::Message.find(1, :include => [:series, :speaker], :params => {quantity: 20, page: 2})
Access properties from the results:
msg.title
msg.part
msg.length
msg.date_released
That's it, you're ready to rock!
Configuration
You can configure both the API key and the base URI:
LcApi.key = "K690FKW924CKUCJTH94WK294WK029834SDFJ9862KSDF9234SDKF9421KDVDS"
LcApi::Base.site = "http://0.0.0.0:3000/v1/"
Usage Examples
All examples require an authenticated LifeChurch.tv consumer. See the quick start section above.
Get a message
LcApi::Message.find(1)
Get all messages
LcApi::Message.find(:all)
Get a message and include series and speakers
LcApi::Message.find(1, :include => [:series, :speaker])
Get a message with include and quantity
LcApi::Message.find(1, :include => [:series, :speaker], :params => {quantity: 5})
Get all messages with include, quantity, and page
LcApi::Message.all(:include => [:series, :speaker], :params => {quantity: 5, page: 2})
Access properties on a message
msg.title
msg.part
msg.length
msg.date_released
Access properties on a set of messages
msg = LcApi::Message.all
msg.each do |m|
msg.title
msg.part
end
Resources
- LcApi::Location
- LcApi::Message
- LcApi::Series
Filters
Include
:include => [speaker,series]
Quantity (for Message and Series only)
:quantity => 5
Page (for Message and Series only)
:page => 2
Coming Soon
- Link to API homepage
- Documentation Like to API
- More details on optional params (:includes, :quantity, etc.)
Copyright
Copyright (c) 2014 LifeChurch.tv. See LICENSE for details.