RAAWS : RUBY AMAZON ASSOCIATE WEB SERVICE

Note : NOT USABLE AT THIS STAGE

This library tries to reflect at best Amazon Associate API.
Originaly AAWS was destined to retrieve informations on items,
and it’ll probably stay it’s main use.
Now it has become a rich API with

• Item : ItemSearch, & ItemLookUp
• Tags, Lists, Sellers List, Customer Content, Transactions.
• a full blown RESTfull Cart.
• a lot more Search Indexes & consequent params
• a huge set of Response Group

Real world

What happens in practice is you build a url with lots of params and amazon answer
with an XML file containing all the answers you’ve requested.

Example (without authentication/page/response) :

http://ecs.amazonaws.com/onca/xml?
Operation=ItemSearch&
SearchIndex=DVD&
Director=Charlie%20Chaplin&
Title=Modern%20Times

The most important here is the Operation parameter which tells amazon
if you’re looking for items or willing to modify the cart.
The second most important, when dealing with collections, is in which
Index you’re going to search (book, dvd, toy, music etc).

So how does RAAWS work

1. for collection
   RAAWS::Item.search :dvd_index do |dvd| dvd.director = "Charlie Chaplin" dvd.title = "Modern Times" end

1. for member
   RAAWS::Item.look_up :asin => long_number

1. for PUT
   RAAWS::Cart.add :asin => numnumnum

Misc

is this library totally overkill ?