Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Amazon Simple INterface - Simple ItemLookup for Amazon E-Commerce
Ruby
tree: bf565c006e

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib
spec
.document
.gitignore
.rvmrc
.travis.yml
Gemfile
Gemfile.lock
README.rdoc
asin.gemspec
rakefile.rb

README.rdoc

Installation

Status:

The gem is tested against 1.9.2, 1.9.1 and 1.8.7 (compatibility with Heroku-Bamboo-Stack) and runs smoothly with Rails 3.

gem install asin

Configuration

Since Version 0.2.0 ASIN provides a Rails-Style configuration.

You can put this in a initializer (config/initializers/asin.rb):

ASIN::Configuration.configure do |config|
  config.secret = 'your-secret'
  config.key = 'your-key'
end

The old configuration syntax is still valid:

require 'asin'
include ASIN

# use the configure method to setup your api credentials
configure :secret => 'your-secret', :key => 'your-key'

Usage

# create an ASIN client
client = ASIN.client

# lookup an item with the amazon standard identification number (asin)
item = client.lookup '1430218150'

# have a look at the title of the item
item.title
=> Learn Objective-C on the Mac (Learn Series)

# search for any kind of stuff on amazon with keywords
items = search_keywords 'Learn', 'Objective-C'
items.first.title
=> "Learn Objective-C on the Mac (Learn Series)"

# search for any kind of stuff on amazon with custom parameters
search :Keywords => 'Learn Objective-C', :SearchIndex => :Books
items.first.title
=> "Learn Objective-C on the Mac (Learn Series)"

# access the internal data representation (Hashie::Mash)
item.raw.ItemAttributes.ListPrice.FormattedPrice
=> $39.99

HTTPI

ASIN uses HTTPI as a HTTP-Client adapter. See the HTTPI documentation for how to configure different clients or the logger. As a default HTTPI uses httpclient so you should add that dependency to your project:

gem 'httpclient'

Infos

Have a look at the RDOC for this project, if you want further information.

For more information on the REST calls, have a look at the whole Amazon E-Commerce-API.

The code currently runs best on Ruby-1.9 due to encoding issues with the Amazon REST output (if YOU know how to backport this to 1.8.7, you are welcome!).

Something went wrong with that request. Please try again.