Skip to content

ceberz/Ruby-IActionable

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Overview

Ruby IActionable is a straightforward wrapper for IActionable's restful API. The JSON-encoded responses from IActionable are wrapped on objects that provide a few extra functions here and there, but are mostly just a representation of the API response.

How To Use

Installation

gem install ruby-iactionable

API Credentials And Initialization

Before the API wrapper can be instantiated or used it must be pre-initialized with your IActionable credentials and version number (IActionable supports older versions but recommends staying up to date):

IActionable::Api.init_settings( :app_key => "12345",
                                :api_key => "abcde",
                                :version => 3 )
@api = IActionable::Api.new

The responses for each of the endpoints of IActionable's API are described through example by their documentation. Here is an example of the response from a profile summary returned as objects by the wrapper.

profile_summary = @api.get_profile_summary("user", "username", "zortnac", 10)
profile_summary.display_name # => "Chris Eberz"
profile_summary.identifiers.first # => instance of IActionable::Objects::Identifier
profile_summary.identifiers.first.id_type # => "username"
profile_summary.identifiers.first.id # => "zortnac"

Each object can be dumped back in to its original form of arrays and key/value pairs:

profile_summary.to_hash # => { "DisplayName" => "Chris Eberz", "Identifiers" => [ {"ID" => "zortnac", "IDType" => "username", ...} ] ... }
                        # (not shown in entirety)

IActionable

Visit their website!

Author

Christopher Eberz; chris@chriseberz.com; @zortnac

About

A ruby wrapper for the IActionable gamification API

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages