Episodic Platform SDK for Ruby¶ ↑

• github.com/episodic/episodic-platform-ruby

Ruby client library for Episodic’s Platform REST API

For more information about Episodic’s Platform API see app.episodic.com/help/server_api

Rdocs are located at episodic.github.com/episodic-platform-ruby/doc/index.html

Install the episodic-platform gem

gem install episodic-platform

The Episodic Platform SDK has some dependencies. You will need to install these gems also.

• ‘curb` - v0.6.2.1 curb.rubyforge.org/

• ‘xml-simple` - v1.0.12 xml-simple.rubyforge.org/

• ‘hanna` - v0.1.2 github.com/mislav/hanna

To get started you need to require ‘episodic/platform’:

require 'episodic/platform'

Before you can use any of the object methods, you need to create a connection using Base.establish_connection!. The Base.establish_connection! method requires that you pass your Episodic API Key and Episodic Secret Key.

Episodic::Platform::Base.establish_connection!('my_api_key', 'my_secret_key')

After establishing a connection you can call any of the methods in the Episodic::Platform::QueryMehtods, Episodic::Platform::WriteMehtods or Episodic::Platform::AnaylticsMehtods. Generally these methods will return some subclass of Episodic::Platform::Response which contains the parsed response. However, you can also access the XML response body directly by calling response.xml.

To query for a list of episodes:

response = Episodic::Platform::QueryMethods.episodes({:show_id => "12345678", search_term => "fun", :status => "on_the_air", :sort_by => "air_date"})

puts "There are a total of #{response.total} episodes matching the query"

# For each episode display the episode's name and embed code for the default player.
response.episodes.each do |episode|
    puts episode.name
    default_player = episode.players.detect {|p| p.default}
    puts default_player.embed_code
end

To create a new episode:

# Create the episode and tell Episodic about the video file and thumbnail file to use
response = ::Episodic::Platform::WriteMethods.create_episode("oz04s1q0i29t", "My Episode", {:air_date => Time.now + 1.week, :upload_types => "s3", :video_filename => "my_video.mp4", :thumbnail_filename => "my_thumb.png"})

# Now upload the video and thumbnail.  It is best to upload the thumbnail first since it is usually smaller.
::Episodic::Platform::WriteMethods.upload_file_for_episode(response.upload_for_filepath("/home/videos/my_thumb.png"))
::Episodic::Platform::WriteMethods.upload_file_for_episode(response.upload_for_filepath("/home/videos/my_video.mp4"))

Any errors returned from the Episodic Platform API are converted to exceptions and raised from the called method. For example, the following response would cause Episodic::Platform::InvalidAPIKey to be raised.

<?xml version="1.0" encoding="UTF-8"?>
<error>
    <code>1</code>
    <message>Invalid API Key</message>
</error>

(The MIT License)

Copyright © 2010 Episodic, Inc.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the ‘Software’), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED ‘AS IS’, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.