Sucker

Sucker is a Nokogiri-based Ruby wrapper to the Amazon Product Advertising API. It's fast and supports the entire API.

Usage

Read Amazon's API. Skip to the Operations section if in a hurry.

Set up.

request = Sucker.new(
  :locale        => :us,
  :key           => a_key,
  :secret        => a_secret)

Build a request.

request << {
  'Operation'     => 'ItemLookup',
  'IdType'        => 'ASIN',
  'ItemId'        => 10.asins,
  'ResponseGroup' => 'ItemAttributes' }

Get a response.

response = request.get

Fulfill a business value.

if response.valid?
  response.each('Item') do |item|
    consume item
  end
end

Repeat ad infinitum.

The following are all valid ways to query a response:

items = response.find('Item')
items = response['Item']
items = response.map('Item') { |item| ... }
response.each('Item') { |item| ... }

To dig further into the response object:

p response.valid?,
  response.body,
  response.code,
  response.errors,
  response.has_errors?,
  response.to_hash,
  response.xml

To use multiple local IPs on your server, configure the request object like so:

adapter = request.adapter
adapter.socket_local.host = '10.0.0.2'

Browse the public interface of Sucker here. To see more advanced usage examples such as twenty-item batch requests and remote cart manipulation, read here.

Stubbing in Tests

Try VCR.

Moral of the story

Don't overabstract a spaghetti API.