The following ruby gem encapsulates access to the Sigimera REST API under http://api.sigimera.org. It includes the needed SSL certificate for the HTTPS connections and a detailed documentation. This library will be developed in parallel to the API.
Add this line to your application's Gemfile:
gem 'sigimera'And then execute:
$ bundleOr install it yourself as:
$ gem install sigimeraThis examples are only a short outline how to use the library. For more information read the documentation, checkout the rspecs or look into the source code. To use the library include or execute the following lines:
irb
>> require "sigimera"
>> require "openssl"
>> puts Sigimera::Client.get_api_version
>> puts Sigimera::Client.get_public_crises
>> puts Sigimera::Client.get_public_rss_feed
>> puts Sigimera::Client.get_auth_token("[email protected]", "verySecretPassword")
# see http://api.sigimera.org/dashboard
>> client = Sigimera::Client.new("YourSecretToken")
or
# The username and password are NOT stored, but only used to fetch an
# authentication token
>> client = Sigimera::Client.new(username = "[email protected]", password = "verySecretPassword")
>> puts client.get_latest_crises
>> puts client.get_latest_crises({ :type => "earthquakes" })
>> puts client.get_crises_stat
>> puts client.get_user_statIn order to test this library with the help of rspec you have get first an authentication token under the Developer Dashboard
export AUTH_TOKEN=YourSecretToken
rake specThis library simplifies the Sigimera REST API. If you want learn more about this API you can use the following links:
- Quickstart
- FAQ
- Developer Dashboard: You must be logged in.
(c) 2012 by Sigimera, published under MIT license.
This software is provided "as is" and without any express or implied warranties, including, without limitation, the implied warranties of merchantibility and fitness for a particular purpose.