amazon_product_api 0.1.0

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,6 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in amazon_product_api.gemspec
+gemspec
+
+gem "rake"

data/README.markdown

@@ -0,0 +1,8 @@
+# amazon_product_api
+
+This is a (currently extremely minimal) Ruby client for the Amazon
+Product Advertising REST API.
+
+It takes care of signing your API requests correctly, but *does not*
+parse XML response data, or serialize the response data to Ruby data
+structures.

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/amazon_product_api.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "amazon_product_api/version"
+
+Gem::Specification.new do |s|
+  s.name        = "amazon_product_api"
+  s.version     = AmazonProductAPI::VERSION
+  s.authors     = ["Nick Dainty"]
+  s.email       = ["nick@npad.co.uk"]
+  s.homepage    = "https://github.com/nickpad/amazon_product_api"
+  s.summary     = %q{Amazon Product Advertising API Client}
+  s.description = %q{An extremely minimal client for Amazon Product Advertising REST API}
+
+  s.rubyforge_project = "amazon_product_api"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  # specify any dependencies here; for example:
+  # s.add_development_dependency "rspec"
+  # s.add_runtime_dependency "rest-client"
+end

data/lib/amazon_product_api.rb

@@ -0,0 +1,107 @@
+require 'base64'
+require 'net/http'
+require 'openssl'
+require 'time'
+require 'amazon_product_api/version'
+
+# A very simple client for the Amazon Product Advertising API.
+class AmazonProductAPI
+  ENDPOINTS = {
+    :ca => 'https://ecs.amazonaws.ca/onca/xml',
+    :cn => 'https://webservices.amazon.cn/onca/xml',
+    :de => 'https://ecs.amazonaws.de/onca/xml',
+    :es => 'https://webservices.amazon.es/onca/xml',
+    :fr => 'https://ecs.amazonaws.fr/onca/xml',
+    :it => 'https://webservices.amazon.it/onca/xml',
+    :jp => 'https://ecs.amazonaws.jp/onca/xml',
+    :uk => 'https://ecs.amazonaws.co.uk/onca/xml',
+    :us => 'https://webservices.amazon.com/onca/xml'
+  }
+
+  SERVICE = 'AWSECommerceService'
+  API_VERSION = '2011-08-01'
+  AMPERSAND = '&'
+  COMMA = ','
+  PERCENT = '%'
+  HTTPS = 'https'
+  USER_AGENT = "amazon_product_api #{VERSION}"
+  HEADERS = {'User-Agent' => USER_AGENT, 'Accept' => 'application/xml'}
+  DIGEST = OpenSSL::Digest::SHA256.new
+  ENCODE = /([^a-zA-Z0-9_.~-]+)/
+
+  attr_reader :connection
+
+  # Possible locale values are - :ca, :cn, :de, :es, :fr, :it, :jp, :uk, :us
+  #
+  # @param locale [Symbol] locale corresponding to an API endpoint
+  # @param access_key_id [String] your Amazon access key ID
+  # @param secret_access_key [String] your Amazon secret access key
+  # @param associate_tag [String] your Amazon associate tag
+  def initialize(locale, access_key_id, secret_access_key, associate_tag)
+    # Check that the locale provided maps to an endpoint string:
+    raise ArgumentError, "invalid locale '#{locale}'" if ENDPOINTS[locale].nil?
+
+    @endpoint = URI.parse(ENDPOINTS[locale])
+    @access_key_id = access_key_id
+    @secret_access_key = secret_access_key
+    @associate_tag = associate_tag
+    @connection = Net::HTTP.new(@endpoint.host, @endpoint.port)
+    @default_params = {
+      'Service' => SERVICE,
+      'Version' => API_VERSION,
+      'AWSAccessKeyId' => @access_key_id,
+      'AssociateTag' => @associate_tag
+    }
+
+    if @endpoint.scheme == HTTPS
+      @connection.use_ssl = true
+    end
+  end
+
+  # @param operation [String] the operation name
+  # @param response_groups [Array<String>] a list of response groups
+  # @param operation_params [Hash] all other parameters required by the operation
+  # @return [Net::HTTPResponse]
+  def get(operation, response_groups, operation_params = {})
+    base_params = {
+      'Operation' => operation,
+      'ResponseGroup' => response_groups.join(COMMA),
+      'Timestamp' => Time.now.xmlschema
+    }
+
+    unsigned_params = operation_params.merge(@default_params.merge(base_params))
+
+    signed_params = unsigned_params.merge({'Signature' => signature(unsigned_params)})
+
+    request_uri = @endpoint.dup
+    request_uri.query = query_string(signed_params)
+
+    @connection.request(Net::HTTP::Get.new(request_uri.to_s, HEADERS))
+  end
+
+  private
+
+  # @param string [String] the string to URL encode
+  # @return [String] the URL encoded string
+  def url_encode(string)
+    string.gsub(ENCODE) do
+      PERCENT + $1.unpack('H2' * $1.bytesize).join(PERCENT).upcase
+    end
+  end
+
+  # @param params [Hash]
+  # @return [String]
+  def query_string(params)
+    params.map do |key, value|
+      "%s=%s" % [key, url_encode(value)]
+    end.sort.join(AMPERSAND)
+  end
+
+  # @param params [Hash]
+  # @return [String] the request signature
+  def signature(params)
+    signable = "GET\n%s\n%s\n%s" % [@endpoint.host, @endpoint.path, query_string(params)]
+    hmac = OpenSSL::HMAC.digest(DIGEST, @secret_access_key, signable)
+    Base64.encode64(hmac).chomp
+  end
+end

data/lib/amazon_product_api/version.rb

@@ -0,0 +1,3 @@
+class AmazonProductAPI
+  VERSION = "0.1.0"
+end

metadata

@@ -0,0 +1,52 @@
+--- !ruby/object:Gem::Specification
+name: amazon_product_api
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Nick Dainty
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-02-14 00:00:00.000000000 Z
+dependencies: []
+description: An extremely minimal client for Amazon Product Advertising REST API
+email:
+- nick@npad.co.uk
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- README.markdown
+- Rakefile
+- amazon_product_api.gemspec
+- lib/amazon_product_api.rb
+- lib/amazon_product_api/version.rb
+homepage: https://github.com/nickpad/amazon_product_api
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: amazon_product_api
+rubygems_version: 1.8.11
+signing_key: 
+specification_version: 3
+summary: Amazon Product Advertising API Client
+test_files: []