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 (c) 2014 LifeChurch.tv. See LICENSE for details.