vacuum 2.2.0 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: de7766702e1ee1d5084f61f8a337ff64b9e1210fd70167ee8e932b742eb522e5
-  data.tar.gz: b2a917e6f5d91bf0177471a65d319bc0d4438b773643d977f53c148d7d2f3770
+  metadata.gz: 93f97f47ef585594e52efc75ac3824e47992ad0ac6cbd688f05363579c9feff3
+  data.tar.gz: 4d0399b9b897cd955cb3c2739a3b2fcb4e393c6ee092270d21d28dab8ee503fc
 SHA512:
-  metadata.gz: 276f630beba5150eb04b20c81ab9feb41db2488773e548da9d9f0df8c3b6a4197eb1948b84d467614de450b74e81023ef8ce5533abb03f4ebf8fec27a322b8a5
-  data.tar.gz: 87b683c87cb51462030f0ba2880e54e1b683723179a658f94dec92cad496b5ae5133c8cfd70b2844b187a108162adca3a3f4153cc5c45a5301826342e9040507
+  metadata.gz: eac6cca761cd2ccc75e7eb9d626398505c06400116efe5bb765e5112debb0f3b22da3dab840aa1bbde19de752d841bd836029c6c1bb7f3b12738d74bfecd0e3b
+  data.tar.gz: 8571a8e9c4b64b71038bf7713364c8b56bca14bb08abae6743aaf2cea0a976fe1b0025432ad659b300d8d5763deb05bd9ff4200bdfcb80e52de9a2f3d3e8952c

data/README.md

@@ -1,211 +1,138 @@
 # Vacuum
-[![Travis](https://travis-ci.org/hakanensari/vacuum.svg)](https://travis-ci.org/hakanensari/vacuum)
 
-Vacuum is a fast, light-weight Ruby wrapper to the [Amazon Product Advertising API](https://affiliate-program.amazon.com/gp/advertising/api/detail/main.html).
+[![CircleCI](https://circleci.com/gh/hakanensari/vacuum/tree/master.svg?style=svg)](https://circleci.com/gh/hakanensari/vacuum/tree/master)
+
+Vacuum is a light-weight Ruby wrapper to [Amazon Product Advertising API 5.0](https://webservices.amazon.com/paapi5/documentation/). The API provides programmatic access to search and get detailed product information on the Amazon marketplaces.
 
 ![vacuum](http://f.cl.ly/items/2k2X0e2u0G3k1c260D2u/vacuum.png)
 
 ## Usage
 
-Refer to the [API docs](https://docs.aws.amazon.com/AWSECommerceService/latest/DG/CHAP_ApiReference.html) as necessary.
-
-### Prerequisite
+Vacuum follows the nomenclature of the Product Advertising API. The examples below are based on examples in the [Amazon docs](https://webservices.amazon.com/paapi5/documentation/).
 
-You must [register as an affiliate](https://affiliate-program.amazon.com) to access the API. Amazon will issue your AWS credentials when you register.
+### Getting Started
 
-### Setup
+You need to [register as an affiliate](https://affiliate-program.amazon.com) and [apply for API access](https://affiliate-program.amazon.com/assoc_credentials/home) on each marketplace you want to query product information.
 
-Create a request:
+Create a request with your marketplace credentials, passing the two-letter country code of the marketplace.
 
 ```ruby
-request = Vacuum.new
+request = Vacuum.new(marketplace: 'US',
+                     access_key: '<ACCESS_KEY>',
+                     secret_key: '<SECRET_KEY>',
+                     partner_tag: '<PARTNER_TAG>')
 ```
 
-The locale will default to the US. To use another locale, reference its two-letter country code:
+Vacuum uses [HTTPI](https://github.com/savonrb/httpi) under the hood. You can swap the HTTP library it uses if you prefer an alternative one for speed or introspection.
 
 ```ruby
-request = Vacuum.new('GB')
+HTTPI.adapter = :http
 ```
 
-Configure the request credentials:
+### Operations
 
-```ruby
-request.configure(
-  aws_access_key_id: 'key',
-  aws_secret_access_key: 'secret',
-  associate_tag: 'tag'
-)
-```
+#### GetBrowseNodes
 
-You can omit the above if you set your key and secret as environment variables:
-
-```sh
-export AWS_ACCESS_KEY_ID=key
-export AWS_SECRET_ACCESS_KEY=secret
-```
-
-You will still need to set an associate tag:
+Given a BrowseNodeId, the `GetBrowseNodes` operation returns details about the specified browse node like name, children and ancestors depending on the resources specified in the request. The names and browse node IDs of the children and ancestor browse nodes are also returned. `GetBrowseNodes` enables you to traverse the browse node hierarchy to find a browse node.
 
 ```ruby
-request.associate_tag = 'tag'
+request.get_browse_nodes(
+  browse_node_ids: ['283155', '3040'],
+  resources: ['BrowseNodes.Ancestor', 'BrowseNodes.Children']
+)
 ```
 
-Provided you are looking to earn commission, you have to register independently with each locale you query. Otherwise, you may reuse any dummy associate tag.
+#### GetItems
 
-The API version defaults to `2013-08-01`. To use another version, reference its date string:
+Given an Item identifier, the `GetItems` operation returns the item attributes, based on the resources specified in the request.
 
 ```ruby
-request.version = '2011-08-01'
+request.get_items(
+  item_ids: ['B0199980K4', 'B000HZD168', 'B01180YUXS', 'B00BKQTA4A'],
+  resources: ['Images.Primary.Small', 'ItemInfo.Title', 'ItemInfo.Features',
+              'Offers.Summaries.HighestPrice' , 'ParentASIN']
+)
 ```
 
-### Request
-
-#### Browse Node Lookup
+#### GetVariations
 
-**BrowseNodeLookup** returns a specified browse node’s name and ancestors:
+Given an ASIN, the `GetVariations` operation returns a set of items that are the same product, but differ according to a consistent theme, for example size and color. These items which differ according to a consistent theme are called variations. A variation is a child ASIN. The parent ASIN is an abstraction of the children items. For example, a shirt is a parent ASIN and parent ASINs cannot be sold. A child ASIN would be a blue shirt, size 16, sold by MyApparelStore. This child ASIN is one of potentially many variations. The ways in which variations differ are called dimensions.
 
 ```ruby
-response = request.browse_node_lookup(
-  query: {
-    'BrowseNodeId' => 123
-  }
+request.get_variations(
+  asin: 'B00422MCUS',
+  resources: ['ItemInfo.Title', 'VariationSummary.Price.HighestPrice',
+              'VariationSummary.Price.LowestPrice',
+              'VariationSummary.VariationDimension']
 )
 ```
 
-#### Cart Operations
+#### SearchItems
 
-The **CartCreate** operation creates a remote shopping cart:
+The `SearchItems` operation searches for items on Amazon based on a search query. The Amazon Product Advertising API returns up to ten items per search request.
 
 ```ruby
-response = request.cart_create(
-  query: {
-    'HMAC' => 'secret',
-    'Item.1.OfferListingId' => '123',
-    'Item.1.Quantity' => 1
-  }
-)
+request.search_items(keywords: 'harry potter')
 ```
 
-The **CartAdd** operation adds items to an existing remote shopping cart:
-
-```ruby
-response = request.cart_add(
-  query: {
-    'CartId' => '123',
-    'HMAC' => 'secret',
-    'Item.1.OfferListingId' => '123',
-    'Item.1.Quantity' => 1
-  }
-)
-```
+### Response
 
-The **CartClear** operation removes all of the items in a remote shopping cart:
+The quick and dirty way to consume a response is to parse into a Ruby hash:
 
 ```ruby
-response = request.cart_clear(
-  query: {
-    'CartId' => '123',
-    'HMAC' => 'secret'
-  }
-)
+response.to_h
 ```
 
-The **CartGet** operation retrieves the IDs, quantities, and prices of the items, including SavedForLater ones, in a remote shopping cart:
+You can also `#dig` into the returned Hash:
 
 ```ruby
-response = request.cart_get(
-  query: {
-    'CartId' => '123',
-    'HMAC' => 'secret',
-    'CartItemId' => '123'
-  }
-)
+response.dig('ItemsResult', 'Items')
 ```
 
-#### Item Lookup
-
-The **ItemLookup** operation returns some or all of the attributes of an item, depending on the response group specified in the request. By default, the operation returns an item’s ASIN, manufacturer, product group, and title.
+You can extend Vacuum with a custom parser. Just swap the original with a class or module that responds to `.parse`.
 
 ```ruby
-response = request.item_lookup(
-  query: {
-    'ItemId' => '0679753354'
-  }
-)
+response.parser = MyParser
+response.parse
 ```
 
-#### Item Search
-
-The **ItemSearch** operation returns items that satisfy the search criteria, including one or more search indices.
-
-```ruby
-response = request.item_search(
-  query: {
-    'Keywords' => 'Architecture',
-    'SearchIndex' => 'Books'
-  }
-)
-```
+If no custom parser is set, `Vacuum::Response#parse` delegates to `#to_h`.
 
-#### Similarity Lookup
+### VCR Support
 
-The **SimilarityLookup** operation returns up to ten products per page that are similar to one or more items specified in the request. This operation is typically used to pique a customer’s interest in buying something similar to what they’ve already ordered.
+If you are using [VCR](https://github.com/vcr/vcr) to test an app that accesses the Product Advertising API, you can use the custom VCR matcher of Vacuum to stub requests.
 
 ```ruby
-response = request.similarity_lookup(
-  query: {
-    'ItemId' => '0679753354'
-  }
-)
-```
+require 'vacuum/matcher'
 
-#### Configuring a request
+VCR.insert_cassette('paapi', match_requests_on: [Vacuum::Matcher])
+```
 
-Vacuum wraps [Excon](https://github.com/geemus/excon). Use the latter's API to tweak your request.
+## Testing
 
-For example, to use a persistent connection:
+Tests should pass as-is once you install dependencies.
 
-```ruby
-response = request.item_search(
-  query: {
-    'ItemId' => '0679753354'
-  },
-  persistent: true
-)
+```sh
+bundle exec rake
 ```
 
-### Response
+By default, all requests are stubbed. Use the `RECORD` env var to record new or modified interactions.
 
-The quick and dirty way to consume a response is to parse into a Ruby hash:
-
-```ruby
-response.to_h
+```sh
+bundle exec RECORD=true rake
 ```
 
-You can also `#dig` into returned Hash:
+You can also run tests against live data.
 
-```ruby
-response.dig('ItemSearchResponse', 'Items', 'Item')
+```shell
+bundle exec LIVE=true rake
 ```
 
-In production, you may prefer to use a custom parser to do some XML heavy-lifting:
+In either case, you will want to add actual API credentials to a [`locales.yml`](https://github.com/hakanensari/vacuum/blob/master/test/locales.yml.example) file in the `test` directory.
 
-```ruby
-class MyParser
-  # A parser has to respond to this.
-  def self.parse(body)
-    new(body)
-  end
-
-  def initialize(body)
-    @body = body
-  end
+## Getting Help
 
-  # Implement parser here.
-end
+* Ask specific questions about the API on the [Amazon forum](https://forums.aws.amazon.com/forum.jspa?forumID=9).
+* Report bugs and discuss potential features in [GitHub issues](https://github.com/hakanensari/vacuum/issues).
 
-response.parser = MyParser
-response.parse
-```
 
-If no custom parser is set, `Vacuum::Response#parse` delegates to `#to_h`.

data/lib/vacuum.rb

@@ -1,14 +1,15 @@
 # frozen_string_literal: true
 
 require 'forwardable'
+
 require 'vacuum/request'
 require 'vacuum/version'
 
-# Vacuum is a Ruby wrapper to the Amazon Product Advertising API.
+# Ruby wrapper to the Amazon Product Advertising API
 module Vacuum
   class << self
     extend Forwardable
 
-    def_delegator Vacuum::Request, :new
+    def_delegator 'Vacuum::Request', :new
   end
 end

data/lib/vacuum/locale.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Vacuum
+  # The target Amazon locale
+  # @api private
+  class Locale
+    class NotFound < ArgumentError; end
+
+    attr_reader :code, :domain, :region
+
+    def self.find(code)
+      code = code.to_sym.downcase
+      code = :gb if code == :uk
+
+      @all.find { |locale| locale.code == code } || raise(NotFound)
+    end
+
+    def initialize(code, domain, region)
+      @code = code
+      @domain = domain
+      @region = region
+    end
+
+    def endpoint
+      "webservices.#{domain}"
+    end
+
+    def marketplace
+      "www.#{domain}"
+    end
+
+    def build_url(operation)
+      "https://#{endpoint}/paapi5/#{operation.downcase}"
+    end
+
+    @all = [
+      [:au, 'amazon.com.au', 'us-west-2'],
+      [:br, 'amazon.com.br', 'us-east-1'],
+      [:ca, 'amazon.ca', 'us-east-1'],
+      [:fr, 'amazon.fr', 'eu-west-1'],
+      [:de, 'amazon.de', 'eu-west-1'],
+      [:in, 'amazon.in', 'eu-west-1'],
+      [:it, 'amazon.it', 'eu-west-1'],
+      [:jp, 'amazon.co.jp', 'us-west-2'],
+      [:mx, 'amazon.com.mx', 'us-east-1'],
+      [:es, 'amazon.es', 'eu-west-1'],
+      [:tr, 'amazon.com.tr', 'eu-west-1'],
+      [:ae, 'amazon.ae', 'eu-west-1'],
+      [:gb, 'amazon.co.uk', 'eu-west-1'],
+      [:us, 'amazon.com', 'us-east-1']
+    ].map { |attributes| new(*attributes) }
+  end
+end

data/lib/vacuum/matcher.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require 'json'
+
+module Vacuum
+  # Custom VCR matcher for stubbing calls to the Product Advertising API
+  # @api private
+  class Matcher
+    IGNORED_KEYS = %w[PartnerTag].freeze
+
+    attr_reader :requests
+
+    def self.call(*requests)
+      new(*requests).compare
+    end
+
+    def initialize(*requests)
+      @requests = requests
+    end
+
+    def compare
+      uris.reduce(:==) && bodies.reduce(:==)
+    end
+
+    private
+
+    def uris
+      requests.map(&:uri)
+    end
+
+    def bodies
+      requests.map do |req|
+        params = JSON.parse(req.body)
+        IGNORED_KEYS.each { |k| params.delete(k) }
+
+        params
+      end
+    end
+  end
+end

data/lib/vacuum/request.rb

@@ -1,122 +1,187 @@
 # frozen_string_literal: true
 
-require 'jeff'
+require 'aws-sigv4'
+require 'httpi'
+require 'json'
+
+require 'vacuum/locale'
 require 'vacuum/response'
 
 module Vacuum
-  # An Amazon Product Advertising API request.
+  # A request to the Amazon Product Advertising API
   class Request
-    include Jeff
-
-    BadLocale = Class.new(ArgumentError)
-
-    LATEST_VERSION = '2013-08-01'
-
-    HOSTS = {
-      'AU' => 'webservices.amazon.com.au',
-      'BR' => 'webservices.amazon.com.br',
-      'CA' => 'webservices.amazon.ca',
-      'CN' => 'webservices.amazon.cn',
-      'DE' => 'webservices.amazon.de',
-      'ES' => 'webservices.amazon.es',
-      'FR' => 'webservices.amazon.fr',
-      'GB' => 'webservices.amazon.co.uk',
-      'IN' => 'webservices.amazon.in',
-      'IT' => 'webservices.amazon.it',
-      'JP' => 'webservices.amazon.co.jp',
-      'MX' => 'webservices.amazon.com.mx',
-      'TR' => 'webservices.amazon.com.tr',
-      'US' => 'webservices.amazon.com'
-    }.freeze
-
-    OPERATIONS = %w[
-      BrowseNodeLookup
-      CartAdd
-      CartClear
-      CartCreate
-      CartGet
-      CartModify
-      ItemLookup
-      ItemSearch
-      SimilarityLookup
-    ].freeze
-    private_constant :OPERATIONS
-
-    params 'AssociateTag' => -> { associate_tag },
-           'Service' => 'AWSECommerceService',
-           'SubscriptionId' => -> { subscription_id },
-           'Version' => -> { version }
-
-    attr_accessor :associate_tag, :subscription_id
-    attr_writer :version
-
-    # Create a new request for given locale.
-    #
-    # locale - The String Product Advertising API locale (default: US).
-    # secure - Whether to use the secure version of the endpoint (default:
-    #          false)
-    #
-    # Raises a Bad Locale error if locale is not valid.
-    def initialize(locale = 'US', secure = false)
-      locale = 'GB' if locale == 'UK'
-      host = HOSTS.fetch(locale) { raise BadLocale }
-      @aws_endpoint = "#{secure ? 'https' : 'http'}://#{host}/onca/xml"
+    SERVICE = 'ProductAdvertisingAPI'
+    private_constant :SERVICE
+
+    # @api private
+    attr_reader :access_key, :secret_key, :locale, :partner_tag, :partner_type
+
+    # Creates a new request
+    # @param [Symbol,String] marketplace the two-letter country code of the
+    #   target Amazon locale
+    # @param [String] access_key your access key
+    # @param [String] secret_key your secret key
+    # @param [String] partner_tag your partner tag
+    # @param [String] partner_type your partner type
+    def initialize(marketplace: :us, access_key:, secret_key:, partner_tag:,
+                   partner_type: 'Associates')
+      @locale = Locale.find(marketplace)
+      @access_key = access_key
+      @secret_key = secret_key
+      @partner_tag = partner_tag
+      @partner_type = partner_type
+    end
+
+    # Returns details about specified browse nodes
+    # @see https://webservices.amazon.com/paapi5/documentation/getbrowsenodes.html
+    # @overload get_browse_nodes(browse_node_ids:, languages_of_preference: nil, marketplace: nil, partner_tag: nil, partner_type: nil, resources: nil)
+    #   @param [Array<String,Integer>,String,Integer] browse_node_ids
+    #   @param [Array<String>,nil] languages_of_preference
+    #   @param [String,nil] marketplace
+    #   @param [String,nil] partner_tag
+    #   @param [String,nil] partner_type
+    #   @param [Array<String>,nil] resources
+    # @return [Response]
+    def get_browse_nodes(browse_node_ids:, **params)
+      params.update(browse_node_ids: Array(browse_node_ids))
+      request('GetBrowseNodes', params)
+    end
+
+    # Returns the attributes of one or more items
+    # @see https://webservices.amazon.com/paapi5/documentation/get-items.html
+    # @overload get_items(condition: nil, currency_of_preference: nil, item_id_type: nil, item_ids:, languages_of_preference: nil, marketplace: nil, merchant: nil, offer_count: nil, partner_tag: nil, partner_type: nil, resources: nil)
+    #   @param [String,nil] condition
+    #   @param [String,nil] currency_of_preference
+    #   @param [String,nil] item_id_type
+    #   @param [Array<String>,String] item_ids
+    #   @param [Array<String>,nil] languages_of_preference
+    #   @param [String,nil] marketplace
+    #   @param [String,nil] merchant
+    #   @param [Integer,nil] offer_count
+    #   @param [String,nil] partner_tag
+    #   @param [String,nil] partner_type
+    #   @param [Array<String>,nil] resources
+    # @return [Response]
+    def get_items(item_ids:, **params)
+      params.update(item_ids: Array(item_ids))
+      request('GetItems', params)
+    end
+
+    # Returns a set of items that are the same product, but differ according to
+    # a consistent theme
+    # @see https://webservices.amazon.com/paapi5/documentation/get-variations.html
+    # @overload get_variations(asin:, condition: nil, currency_of_preference: nil, languages_of_preference: nil, marketplace: nil, merchant: nil, offer_count: nil, partner_tag: nil, partner_type: nil, resources: nil, variation_count: nil, variation_page: nil)
+    #   @param [String] asin
+    #   @param [String,nil] condition
+    #   @param [String,nil] currency_of_preference
+    #   @param [Array<String>,nil] languages_of_preference
+    #   @param [String,nil] marketplace
+    #   @param [String,nil] merchant
+    #   @param [Integer,nil] offer_count
+    #   @param [String,nil] partner_tag
+    #   @param [String,nil] partner_type
+    #   @param [Array<String>,nil] resources
+    #   @param [Integer,nil] variation_count
+    #   @param [Integer,nil] variation_page
+    #   @return [Response]
+    def get_variations(**params)
+      request('GetVariations', params)
+    end
+
+    # Searches for items on Amazon based on a search query
+    # @see https://webservices.amazon.com/paapi5/documentation/search-items.html
+    # @overload search_items(actor: nil, artist: nil, author: nil, availability: nil, brand: nil, browse_node_id: nil, condition: nil, currency_of_preference: nil, delivery_flags: nil, item_count: nil, item_page: nil, keywords: nil, languages_of_preference: nil, marketplace: nil, max_price: nil, merchant: nil, min_price: nil, min_reviews_rating: nil, min_savings_percent: nil, offer_count: nil, partner_tag: nil, partner_type: nil, resources: nil, search_index: nil, sort_by: nil, title: nil)
+    #   @param [String,nil] actor
+    #   @param [String,nil] artist
+    #   @param [String,nil] availability
+    #   @param [String,nil] brand
+    #   @param [Integer,nil] browse_node_id
+    #   @param [String,nil] condition
+    #   @param [String,nil] currency_of_preference
+    #   @param [Array<String>,nil] delivery_flags
+    #   @param [Integer,nil] item_count
+    #   @param [Integer,nil] item_page
+    #   @param [String,nil] keywords
+    #   @param [Array<String>,nil] languages_of_preference
+    #   @param [Integer,nil] max_price
+    #   @param [String,nil] merchant
+    #   @param [Integer,nil] min_price
+    #   @param [Integer,nil] min_reviews_rating
+    #   @param [Integer,nil] min_savings_percent
+    #   @param [Integer,nil] offer_count
+    #   @param [Hash,nil] properties
+    #   @param [Array<String>,nil] resources
+    #   @param [String,nil] search_index
+    #   @param [String,nil] sort_by
+    #   @param [String,nil] title
+    # @return [Response]
+    def search_items(**params)
+      request('SearchItems', params)
     end
 
-    # Configure the Amazon Product Advertising API request.
-    #
-    # credentials - The Hash credentials of the API endpoint.
-    #               :aws_access_key_id     - The String Amazon Web Services
-    #                                        (AWS) key.
-    #               :aws_secret_access_key - The String AWS secret.
-    #               :associate_tag         - The String Associate Tag.
-    #               :aws_version           - The String AWS version.
-    #
-    # Returns self.
-    def configure(credentials)
-      credentials.each { |key, val| send("#{key}=", val) }
-      self
+    private
+
+    def request(operation, params)
+      body = build_body(params)
+      signature = sign(operation, body)
+
+      request = HTTPI::Request.new(
+        headers: request_headers(operation, signature),
+        url: locale.build_url(operation),
+        body: body
+      )
+
+      Response.new(HTTPI.post(request))
     end
 
-    # Returns the API version.
-    def version
-      @version || LATEST_VERSION
+    def sign(operation, body)
+      signer.sign_request(
+        http_method: 'POST',
+        url: locale.build_url(operation),
+        headers: headers(operation),
+        body: body
+      )
     end
 
-    # Execute an API operation. See `OPERATIONS` constant above for available
-    # operation names.
-    #
-    # params - The Hash request parameters.
-    # opts   - Options passed to Excon (default: {}).
-    #
-    # Alternatively, pass Excon options as first argument and include request
-    # parameters as query key.
-    #
-    # Examples
-    #
-    #   req.item_search(
-    #     'SearchIndex' => 'All',
-    #     'Keywords' => 'Architecture'
-    #   )
-    #
-    #   req.item_search(
-    #     query: {
-    #       'SearchIndex' => 'All',
-    #       'Keywords' => 'Architecture'
-    #     },
-    #     persistent: true
-    #   )
-    #
-    # Returns a Vacuum Response.
-    OPERATIONS.each do |operation|
-      method_name = operation.gsub(/(.)([A-Z])/, '\1_\2').downcase
-      define_method(method_name) do |params, opts = {}|
-        params.key?(:query) ? opts = params : opts.update(query: params)
-        opts[:expects] ||= [200, 400, 403]
-        opts[:query].update('Operation' => operation)
-
-        Response.new(get(opts))
+    def request_headers(operation, signature)
+      headers(operation).merge(
+        'Content-Type' => 'application/json; charset=utf-8',
+        'Authorization' => signature.headers['authorization'],
+        'X-Amz-Content-Sha256' => signature.headers['x-amz-content-sha256'],
+        'X-Amz-Date' => signature.headers['x-amz-date'],
+        'Host' => locale.endpoint
+      )
+    end
+
+    def headers(operation)
+      {
+        'X-Amz-Target' => "com.amazon.paapi5.v1.#{SERVICE}v1.#{operation}",
+        'Content-Encoding' => 'amz-1.0'
+      }
+    end
+
+    def signer
+      Aws::Sigv4::Signer.new(
+        service: SERVICE,
+        region: locale.region,
+        access_key_id: access_key,
+        secret_access_key: secret_key,
+        http_method: 'POST',
+        endpoint: locale.endpoint
+      )
+    end
+
+    def build_body(params)
+      hsh = { 'PartnerTag' => partner_tag,
+              'PartnerType' => partner_type }
+
+      params.each do |key, val|
+        key = key.to_s.split('_')
+                 .map { |word| word == 'asin' ? 'ASIN' : word.capitalize }.join
+        hsh[key] = val
       end
+
+      JSON.generate(hsh)
     end
   end
 end