A simple Ruby client for the Altmetric API.
Provides a basic client object for interacting with the API. Provides quick access to the JSON results or direct access to API responses.
[sudo] gem install altmetric.rb
Relies on the json, uri_template and httpclient gems.
The client can be created with an API key which is required to raise usage limits and also to access
the commercial parts of the API (the fetch) calls
opts = {
:apikey => "12345",
:user_agent => "MyCoolApp/1.0"
}
client = Altmetric::Client.new(opts)
Default User-Agent is currently altmetric-ruby-client/0.0.1
require 'altmetric'
client = Altmetric::Client.new()
stats = client.doi("10.1038/news.2011.490")
#do something with the stats
There are methods on the client object that match each of the Altmetric API entry points, e.g. doi,
arxiv, pmid, etc.
Read the Altmetric API documentation for notes on the structure of the responses and additional API parameters.
The client object will automatically inspect all responses and extract the HTTP headers that Altmetric uses for rate limiting.
The latest header values are automatically added as integers to the Altmetric::Client::LIMITS hash,
keyed on the header name. This simplifies monitoring limits over several requests, which may use different
clients.
This work is hereby released into the Public Domain.
To view a copy of the public domain dedication, visit http://creativecommons.org/licenses/publicdomain or send a letter to Creative Commons, 559 Nathan Abbott Way, Stanford, California 94305, USA.