peddler 3.0.0.beta1 → 4.0.0

data/lib/peddler/{api → apis}/amazon_warehousing_and_distribution_2024_05_09.rb

@@ -3,7 +3,13 @@
 require "peddler/api"
 
 module Peddler
-  class API
+  class << self
+    def amazon_warehousing_and_distribution_2024_05_09(...)
+      APIs::AmazonWarehousingAndDistribution20240509.new(...)
+    end
+  end
+
+  module APIs
     # The Selling Partner API for Amazon Warehousing and Distribution
     #
     # The Selling Partner API for Amazon Warehousing and Distribution (AWD) provides programmatic access to information
@@ -11,35 +17,39 @@ module Peddler
     class AmazonWarehousingAndDistribution20240509 < API
       # Retrieves an AWD inbound shipment.
       #
-      # @param [String] shipment_id ID for the shipment. A shipment contains the cases being inbounded.
-      # @param [String] sku_quantities If equal to `SHOW`, the response includes the shipment SKU quantity details.
+      # @note This operation can make a static sandbox call.
+      # @param shipment_id [String] ID for the shipment. A shipment contains the cases being inbounded.
+      # @param sku_quantities [String] If equal to `SHOW`, the response includes the shipment SKU quantity details.
       #   Defaults to `HIDE`, in which case the response does not contain SKU quantities
-      # @return [Hash] The API response
-      def get_inbound_shipment(shipment_id, sku_quantities: nil)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_inbound_shipment(shipment_id, sku_quantities: nil, rate_limit: 2.0)
         path = "/awd/2024-05-09/inboundShipments/#{shipment_id}"
         params = {
           "skuQuantities" => sku_quantities,
         }.compact
 
-        rate_limit(2.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Retrieves a summary of all the inbound AWD shipments associated with a merchant, with the ability to apply
       # optional filters.
       #
-      # @param [String] sort_by Field to sort results by. By default, the response will be sorted by UPDATED_AT.
-      # @param [String] sort_order Sort the response in ASCENDING or DESCENDING order. By default, the response will be
+      # @note This operation can make a static sandbox call.
+      # @param sort_by [String] Field to sort results by. By default, the response will be sorted by UPDATED_AT.
+      # @param sort_order [String] Sort the response in ASCENDING or DESCENDING order. By default, the response will be
       #   sorted in DESCENDING order.
-      # @param [String] shipment_status Filter by inbound shipment status.
-      # @param [String] updated_after List the inbound shipments that were updated after a certain time (inclusive). The
-      #   date must be in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.
-      # @param [String] updated_before List the inbound shipments that were updated before a certain time (inclusive).
-      #   The date must be in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.
-      # @param [Integer] max_results Maximum number of results to return.
-      # @param [String] next_token Token to retrieve the next set of paginated results.
-      # @return [Hash] The API response
+      # @param shipment_status [String] Filter by inbound shipment status.
+      # @param updated_after [String] List the inbound shipments that were updated after a certain time (inclusive). The
+      #   date must be in {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} format.
+      # @param updated_before [String] List the inbound shipments that were updated before a certain time (inclusive).
+      #   The date must be in {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} format.
+      # @param max_results [Integer] Maximum number of results to return.
+      # @param next_token [String] Token to retrieve the next set of paginated results.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
       def list_inbound_shipments(sort_by: nil, sort_order: nil, shipment_status: nil, updated_after: nil,
-        updated_before: nil, max_results: nil, next_token: nil)
+        updated_before: nil, max_results: 25, next_token: nil, rate_limit: 1.0)
         path = "/awd/2024-05-09/inboundShipments"
         params = {
           "sortBy" => sort_by,
@@ -51,19 +61,21 @@ module Peddler
           "nextToken" => next_token,
         }.compact
 
-        rate_limit(1.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Lists AWD inventory associated with a merchant with the ability to apply optional filters.
       #
-      # @param [String] sku Filter by seller or merchant SKU for the item.
-      # @param [String] sort_order Sort the response in `ASCENDING` or `DESCENDING` order.
-      # @param [String] details Set to `SHOW` to return summaries with additional inventory details. Defaults to `HIDE,`
+      # @note This operation can make a static sandbox call.
+      # @param sku [String] Filter by seller or merchant SKU for the item.
+      # @param sort_order [String] Sort the response in `ASCENDING` or `DESCENDING` order.
+      # @param details [String] Set to `SHOW` to return summaries with additional inventory details. Defaults to `HIDE,`
       #   which returns only inventory summary totals.
-      # @param [String] next_token Token to retrieve the next set of paginated results.
-      # @param [Integer] max_results Maximum number of results to return.
-      # @return [Hash] The API response
-      def list_inventory(sku: nil, sort_order: nil, details: nil, next_token: nil, max_results: nil)
+      # @param next_token [String] Token to retrieve the next set of paginated results.
+      # @param max_results [Integer] Maximum number of results to return.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def list_inventory(sku: nil, sort_order: nil, details: nil, next_token: nil, max_results: 25, rate_limit: 2.0)
         path = "/awd/2024-05-09/inventory"
         params = {
           "sku" => sku,
@@ -73,7 +85,7 @@ module Peddler
           "maxResults" => max_results,
         }.compact
 
-        rate_limit(2.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
     end
   end

data/lib/peddler/{api → apis}/aplus_content_2020_11_01.rb

@@ -3,7 +3,13 @@
 require "peddler/api"
 
 module Peddler
-  class API
+  class << self
+    def aplus_content_2020_11_01(...)
+      APIs::AplusContent20201101.new(...)
+    end
+  end
+
+  module APIs
     # Selling Partner API for A+ Content Management
     #
     # With the A+ Content API, you can build applications that help selling partners add rich marketing content to their
@@ -15,92 +21,108 @@ module Peddler
       # metadata of the A+ Content documents. Call the getContentDocument operation to get the actual contents of the A+
       # Content documents.
       #
-      # @param [String] marketplace_id The identifier for the marketplace where the A+ Content is published.
-      # @param [String] page_token A page token from the nextPageToken response element returned by your previous call
+      # @param marketplace_id [String] The identifier for the marketplace where the A+ Content is published.
+      # @param page_token [String] A page token from the nextPageToken response element returned by your previous call
       #   to this operation. nextPageToken is returned when the results of a call exceed the page size. To get the next
       #   page of results, call the operation and include pageToken as the only parameter. Specifying pageToken with any
       #   other parameter will cause the request to fail. When no nextPageToken value is returned there are no more
       #   pages to return. A pageToken value is not usable across different operations.
-      # @return [Hash] The API response
-      def search_content_documents(marketplace_id, page_token: nil)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def search_content_documents(marketplace_id, page_token: nil, rate_limit: 10.0)
+        cannot_sandbox!
+
         path = "/aplus/2020-11-01/contentDocuments"
         params = {
           "marketplaceId" => marketplace_id,
           "pageToken" => page_token,
         }.compact
 
-        rate_limit(10.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Creates a new A+ Content document.
       #
-      # @param [String] marketplace_id The identifier for the marketplace where the A+ Content is published.
-      # @param [Hash] post_content_document_request The content document request details.
-      # @return [Hash] The API response
-      def create_content_document(marketplace_id, post_content_document_request)
+      # @param marketplace_id [String] The identifier for the marketplace where the A+ Content is published.
+      # @param post_content_document_request [Hash] The content document request details.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def create_content_document(marketplace_id, post_content_document_request, rate_limit: 10.0)
+        cannot_sandbox!
+
         path = "/aplus/2020-11-01/contentDocuments"
         body = post_content_document_request
         params = {
           "marketplaceId" => marketplace_id,
         }.compact
 
-        rate_limit(10.0).post(path, body:, params:)
+        meter(rate_limit).post(path, body:, params:)
       end
 
       # Returns an A+ Content document, if available.
       #
-      # @param [String] content_reference_key The unique reference key for the A+ Content document. A content reference
+      # @param content_reference_key [String] The unique reference key for the A+ Content document. A content reference
       #   key cannot form a permalink and may change in the future. A content reference key is not guaranteed to match
       #   any A+ Content identifier.
-      # @param [String] marketplace_id The identifier for the marketplace where the A+ Content is published.
-      # @param [Array<String>] included_data_set The set of A+ Content data types to include in the response.
-      # @return [Hash] The API response
-      def get_content_document(content_reference_key, marketplace_id, included_data_set)
+      # @param marketplace_id [String] The identifier for the marketplace where the A+ Content is published.
+      # @param included_data_set [Array<String>] The set of A+ Content data types to include in the response.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_content_document(content_reference_key, marketplace_id, included_data_set, rate_limit: 10.0)
+        cannot_sandbox!
+
         path = "/aplus/2020-11-01/contentDocuments/#{content_reference_key}"
         params = {
           "marketplaceId" => marketplace_id,
           "includedDataSet" => included_data_set,
         }.compact
 
-        rate_limit(10.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Updates an existing A+ Content document.
       #
-      # @param [String] content_reference_key The unique reference key for the A+ Content document. A content reference
+      # @param content_reference_key [String] The unique reference key for the A+ Content document. A content reference
       #   key cannot form a permalink and may change in the future. A content reference key is not guaranteed to match
       #   any A+ Content identifier.
-      # @param [String] marketplace_id The identifier for the marketplace where the A+ Content is published.
-      # @param [Hash] post_content_document_request The content document request details.
-      # @return [Hash] The API response
-      def update_content_document(content_reference_key, marketplace_id, post_content_document_request)
+      # @param marketplace_id [String] The identifier for the marketplace where the A+ Content is published.
+      # @param post_content_document_request [Hash] The content document request details.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def update_content_document(content_reference_key, marketplace_id, post_content_document_request,
+        rate_limit: 10.0)
+        cannot_sandbox!
+
         path = "/aplus/2020-11-01/contentDocuments/#{content_reference_key}"
         body = post_content_document_request
         params = {
           "marketplaceId" => marketplace_id,
         }.compact
 
-        rate_limit(10.0).post(path, body:, params:)
+        meter(rate_limit).post(path, body:, params:)
       end
 
       # Returns a list of ASINs related to the specified A+ Content document, if available. If you do not include the
       # asinSet parameter, the operation returns all ASINs related to the content document.
       #
-      # @param [String] content_reference_key The unique reference key for the A+ Content document. A content reference
+      # @param content_reference_key [String] The unique reference key for the A+ Content document. A content reference
       #   key cannot form a permalink and may change in the future. A content reference key is not guaranteed to match
       #   any A+ Content identifier.
-      # @param [String] marketplace_id The identifier for the marketplace where the A+ Content is published.
-      # @param [Array<String>] included_data_set The set of A+ Content data types to include in the response. If you do
+      # @param marketplace_id [String] The identifier for the marketplace where the A+ Content is published.
+      # @param included_data_set [Array<String>] The set of A+ Content data types to include in the response. If you do
       #   not include this parameter, the operation returns the related ASINs without metadata.
-      # @param [Array<String>] asin_set The set of ASINs.
-      # @param [String] page_token A page token from the nextPageToken response element returned by your previous call
+      # @param asin_set [Array<String>] The set of ASINs.
+      # @param page_token [String] A page token from the nextPageToken response element returned by your previous call
       #   to this operation. nextPageToken is returned when the results of a call exceed the page size. To get the next
       #   page of results, call the operation and include pageToken as the only parameter. Specifying pageToken with any
       #   other parameter will cause the request to fail. When no nextPageToken value is returned there are no more
       #   pages to return. A pageToken value is not usable across different operations.
-      # @return [Hash] The API response
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
       def list_content_document_asin_relations(content_reference_key, marketplace_id, included_data_set: nil,
-        asin_set: nil, page_token: nil)
+        asin_set: nil, page_token: nil, rate_limit: 10.0)
+        cannot_sandbox!
+
         path = "/aplus/2020-11-01/contentDocuments/#{content_reference_key}/asins"
         params = {
           "marketplaceId" => marketplace_id,
@@ -109,37 +131,44 @@ module Peddler
           "pageToken" => page_token,
         }.compact
 
-        rate_limit(10.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Replaces all ASINs related to the specified A+ Content document, if available. This may add or remove ASINs,
       # depending on the current set of related ASINs. Removing an ASIN has the side effect of suspending the content
       # document from that ASIN.
       #
-      # @param [String] content_reference_key The unique reference key for the A+ Content document. A content reference
+      # @param content_reference_key [String] The unique reference key for the A+ Content document. A content reference
       #   key cannot form a permalink and may change in the future. A content reference key is not guaranteed to match
       #   any A+ content identifier.
-      # @param [String] marketplace_id The identifier for the marketplace where the A+ Content is published.
-      # @param [Hash] post_content_document_asin_relations_request The content document ASIN relations request details.
-      # @return [Hash] The API response
+      # @param marketplace_id [String] The identifier for the marketplace where the A+ Content is published.
+      # @param post_content_document_asin_relations_request [Hash] The content document ASIN relations request details.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
       def post_content_document_asin_relations(content_reference_key, marketplace_id,
-        post_content_document_asin_relations_request)
+        post_content_document_asin_relations_request, rate_limit: 10.0)
+        cannot_sandbox!
+
         path = "/aplus/2020-11-01/contentDocuments/#{content_reference_key}/asins"
         body = post_content_document_asin_relations_request
         params = {
           "marketplaceId" => marketplace_id,
         }.compact
 
-        rate_limit(10.0).post(path, body:, params:)
+        meter(rate_limit).post(path, body:, params:)
       end
 
       # Checks if the A+ Content document is valid for use on a set of ASINs.
       #
-      # @param [String] marketplace_id The identifier for the marketplace where the A+ Content is published.
-      # @param [Array<String>] asin_set The set of ASINs.
-      # @param [Hash] post_content_document_request The content document request details.
-      # @return [Hash] The API response
-      def validate_content_document_asin_relations(marketplace_id, post_content_document_request, asin_set: nil)
+      # @param marketplace_id [String] The identifier for the marketplace where the A+ Content is published.
+      # @param asin_set [Array<String>] The set of ASINs.
+      # @param post_content_document_request [Hash] The content document request details.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def validate_content_document_asin_relations(marketplace_id, post_content_document_request, asin_set: nil,
+        rate_limit: 10.0)
+        cannot_sandbox!
+
         path = "/aplus/2020-11-01/contentAsinValidations"
         body = post_content_document_request
         params = {
@@ -147,20 +176,23 @@ module Peddler
           "asinSet" => asin_set,
         }.compact
 
-        rate_limit(10.0).post(path, body:, params:)
+        meter(rate_limit).post(path, body:, params:)
       end
 
       # Searches for A+ Content publishing records, if available.
       #
-      # @param [String] marketplace_id The identifier for the marketplace where the A+ Content is published.
-      # @param [String] asin The Amazon Standard Identification Number (ASIN).
-      # @param [String] page_token A page token from the nextPageToken response element returned by your previous call
+      # @param marketplace_id [String] The identifier for the marketplace where the A+ Content is published.
+      # @param asin [String] The Amazon Standard Identification Number (ASIN).
+      # @param page_token [String] A page token from the nextPageToken response element returned by your previous call
       #   to this operation. nextPageToken is returned when the results of a call exceed the page size. To get the next
       #   page of results, call the operation and include pageToken as the only parameter. Specifying pageToken with any
       #   other parameter will cause the request to fail. When no nextPageToken value is returned there are no more
       #   pages to return. A pageToken value is not usable across different operations.
-      # @return [Hash] The API response
-      def search_content_publish_records(marketplace_id, asin, page_token: nil)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def search_content_publish_records(marketplace_id, asin, page_token: nil, rate_limit: 10.0)
+        cannot_sandbox!
+
         path = "/aplus/2020-11-01/contentPublishRecords"
         params = {
           "marketplaceId" => marketplace_id,
@@ -168,40 +200,46 @@ module Peddler
           "pageToken" => page_token,
         }.compact
 
-        rate_limit(10.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Submits an A+ Content document for review, approval, and publishing.
       #
-      # @param [String] content_reference_key The unique reference key for the A+ Content document. A content reference
+      # @param content_reference_key [String] The unique reference key for the A+ Content document. A content reference
       #   key cannot form a permalink and may change in the future. A content reference key is not guaranteed to match
       #   any A+ content identifier.
-      # @param [String] marketplace_id The identifier for the marketplace where the A+ Content is published.
-      # @return [Hash] The API response
-      def post_content_document_approval_submission(content_reference_key, marketplace_id)
+      # @param marketplace_id [String] The identifier for the marketplace where the A+ Content is published.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def post_content_document_approval_submission(content_reference_key, marketplace_id, rate_limit: 10.0)
+        cannot_sandbox!
+
         path = "/aplus/2020-11-01/contentDocuments/#{content_reference_key}/approvalSubmissions"
         params = {
           "marketplaceId" => marketplace_id,
         }.compact
 
-        rate_limit(10.0).post(path, params:)
+        meter(rate_limit).post(path, params:)
       end
 
       # Submits a request to suspend visible A+ Content. This neither deletes the content document nor the ASIN
       # relations.
       #
-      # @param [String] content_reference_key The unique reference key for the A+ Content document. A content reference
+      # @param content_reference_key [String] The unique reference key for the A+ Content document. A content reference
       #   key cannot form a permalink and may change in the future. A content reference key is not guaranteed to match
       #   any A+ content identifier.
-      # @param [String] marketplace_id The identifier for the marketplace where the A+ Content is published.
-      # @return [Hash] The API response
-      def post_content_document_suspend_submission(content_reference_key, marketplace_id)
+      # @param marketplace_id [String] The identifier for the marketplace where the A+ Content is published.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def post_content_document_suspend_submission(content_reference_key, marketplace_id, rate_limit: 10.0)
+        cannot_sandbox!
+
         path = "/aplus/2020-11-01/contentDocuments/#{content_reference_key}/suspendSubmissions"
         params = {
           "marketplaceId" => marketplace_id,
         }.compact
 
-        rate_limit(10.0).post(path, params:)
+        meter(rate_limit).post(path, params:)
       end
     end
   end

data/lib/peddler/apis/application_integrations_2024_04_01.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class << self
+    def application_integrations_2024_04_01(...)
+      APIs::ApplicationIntegrations20240401.new(...)
+    end
+  end
+
+  module APIs
+    # The Selling Partner API for third party application integrations.
+    #
+    # With the AppIntegrations API v2024-04-01, you can send notifications to Amazon Selling Partners and display the
+    # notifications in Seller Central.
+    class ApplicationIntegrations20240401 < API
+      # Create a notification for sellers in Seller Central.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param body [Hash] The request body for the `createNotification` operation.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def create_notification(body, rate_limit: 1.0)
+        path = "/appIntegrations/2024-04-01/notifications"
+
+        meter(rate_limit).post(path, body:)
+      end
+
+      # Remove your application's notifications from the Appstore notifications dashboard.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param body [Hash] The request body for the `deleteNotifications` operation.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def delete_notifications(body, rate_limit: 1.0)
+        path = "/appIntegrations/2024-04-01/notifications/deletion"
+
+        meter(rate_limit).post(path, body:)
+      end
+
+      # Records the seller's response to a notification.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param notification_id [String] A `notificationId` uniquely identifies a notification.
+      # @param body [Hash] The request body for the `recordActionFeedback` operation.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def record_action_feedback(notification_id, body, rate_limit: 1.0)
+        path = "/appIntegrations/2024-04-01/notifications/#{notification_id}/feedback"
+
+        meter(rate_limit).post(path, body:)
+      end
+    end
+  end
+end

data/lib/peddler/{api → apis}/application_management_2023_11_30.rb

@@ -3,7 +3,13 @@
 require "peddler/api"
 
 module Peddler
-  class API
+  class << self
+    def application_management_2023_11_30(...)
+      APIs::ApplicationManagement20231130.new(...)
+    end
+  end
+
+  module APIs
     # Selling Partner API for Application Management
     #
     # The Selling Partner API for Application Management lets you programmatically update the client secret on
@@ -14,11 +20,15 @@ module Peddler
       # generated and sent to the developer-registered queue. For more information, refer to [Rotate your application
       # client
       # secret](https://developer-docs.amazon.com/sp-api/v0/docs/application-management-api-v2023-11-30-use-case-guide#tutorial-rotate-your-applications-client-secret).
-      # @return [Hash] The API response
-      def rotate_application_client_secret
+      #
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def rotate_application_client_secret(rate_limit: 0.0167)
+        cannot_sandbox!
+
         path = "/applications/2023-11-30/clientSecret"
 
-        rate_limit(0.0167).post(path)
+        meter(rate_limit).post(path)
       end
     end
   end

data/lib/peddler/{api → apis}/catalog_items_2020_12_01.rb

@@ -3,32 +3,41 @@
 require "peddler/api"
 
 module Peddler
-  class API
+  class << self
+    def catalog_items_2020_12_01(...)
+      APIs::CatalogItems20201201.new(...)
+    end
+  end
+
+  module APIs
     # Selling Partner API for Catalog Items
     #
     # The Selling Partner API for Catalog Items provides programmatic access to information about items in the Amazon
-    # catalog. For more information, see the [Catalog Items API Use Case
-    # Guide](doc:catalog-items-api-v2020-12-01-use-case-guide).
+    # catalog. For more information, see the
+    # {https://developer-docs.amazon.com/sp-api/docs/catalog-items-api-v2020-12-01-use-case-guide Catalog Items API Use
+    # Case Guide}.
     class CatalogItems20201201 < API
       # Search for and return a list of Amazon catalog items and associated information.
       #
-      # @param [Array<String>] keywords A comma-delimited list of words or item identifiers to search the Amazon catalog
+      # @note This operation can make a static sandbox call.
+      # @param keywords [Array<String>] A comma-delimited list of words or item identifiers to search the Amazon catalog
       #   for.
-      # @param [Array<String>] marketplace_ids A comma-delimited list of Amazon marketplace identifiers for the request.
-      # @param [Array<String>] included_data A comma-delimited list of data sets to include in the response. Default:
+      # @param marketplace_ids [Array<String>] A comma-delimited list of Amazon marketplace identifiers for the request.
+      # @param included_data [Array<String>] A comma-delimited list of data sets to include in the response. Default:
       #   summaries.
-      # @param [Array<String>] brand_names A comma-delimited list of brand names to limit the search to.
-      # @param [Array<String>] classification_ids A comma-delimited list of classification identifiers to limit the
+      # @param brand_names [Array<String>] A comma-delimited list of brand names to limit the search to.
+      # @param classification_ids [Array<String>] A comma-delimited list of classification identifiers to limit the
       #   search to.
-      # @param [Integer] page_size Number of results to be returned per page.
-      # @param [String] page_token A token to fetch a certain page when there are multiple pages worth of results.
-      # @param [String] keywords_locale The language the keywords are provided in. Defaults to the primary locale of the
+      # @param page_size [Integer] Number of results to be returned per page.
+      # @param page_token [String] A token to fetch a certain page when there are multiple pages worth of results.
+      # @param keywords_locale [String] The language the keywords are provided in. Defaults to the primary locale of the
       #   marketplace.
-      # @param [String] locale Locale for retrieving localized summaries. Defaults to the primary locale of the
+      # @param locale [String] Locale for retrieving localized summaries. Defaults to the primary locale of the
       #   marketplace.
-      # @return [Hash] The API response
-      def search_catalog_items(keywords, marketplace_ids, included_data: nil, brand_names: nil,
-        classification_ids: nil, page_size: nil, page_token: nil, keywords_locale: nil, locale: nil)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def search_catalog_items(keywords, marketplace_ids, included_data: "summaries", brand_names: nil,
+        classification_ids: nil, page_size: 10, page_token: nil, keywords_locale: nil, locale: nil, rate_limit: 2.0)
         path = "/catalog/2020-12-01/items"
         params = {
           "keywords" => keywords,
@@ -42,20 +51,22 @@ module Peddler
           "locale" => locale,
         }.compact
 
-        rate_limit(2.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Retrieves details for an item in the Amazon catalog.
       #
-      # @param [String] asin The Amazon Standard Identification Number (ASIN) of the item.
-      # @param [Array<String>] marketplace_ids A comma-delimited list of Amazon marketplace identifiers. Data sets in
+      # @note This operation can make a static sandbox call.
+      # @param asin [String] The Amazon Standard Identification Number (ASIN) of the item.
+      # @param marketplace_ids [Array<String>] A comma-delimited list of Amazon marketplace identifiers. Data sets in
       #   the response contain data only for the specified marketplaces.
-      # @param [Array<String>] included_data A comma-delimited list of data sets to include in the response. Default:
+      # @param included_data [Array<String>] A comma-delimited list of data sets to include in the response. Default:
       #   summaries.
-      # @param [String] locale Locale for retrieving localized summaries. Defaults to the primary locale of the
+      # @param locale [String] Locale for retrieving localized summaries. Defaults to the primary locale of the
       #   marketplace.
-      # @return [Hash] The API response
-      def get_catalog_item(asin, marketplace_ids, included_data: nil, locale: nil)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_catalog_item(asin, marketplace_ids, included_data: "summaries", locale: nil, rate_limit: 2.0)
         path = "/catalog/2020-12-01/items/#{asin}"
         params = {
           "marketplaceIds" => marketplace_ids,
@@ -63,7 +74,7 @@ module Peddler
           "locale" => locale,
         }.compact
 
-        rate_limit(2.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
     end
   end