Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Amazon Simple INterface - Simple ItemLookup for Amazon E-Commerce

tree: a661f3f613

Fetching latest commit…

Cannot retrieve the latest commit at this time

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.