peddler 3.0.0.beta1 → 3.0.0

data/lib/peddler/api/vendor_orders_v1.rb

@@ -3,6 +3,12 @@
 require "peddler/api"
 
 module Peddler
+  class << self
+    def vendor_orders_v1(...)
+      API::VendorOrdersV1.new(...)
+    end
+  end
+
   class API
     # Selling Partner API for Retail Procurement Orders
     #
@@ -14,37 +20,37 @@ module Peddler
       # `includeDetails` to false. You can then use the `getPurchaseOrder` operation to receive details for a specific
       # purchase order.
       #
-      # @param [Integer] limit The limit to the number of records returned. Default value is 100 records.
-      # @param [String] created_after Purchase orders that became available after this time will be included in the
+      # @note This operation can make a static sandbox call.
+      # @param limit [Integer] The limit to the number of records returned. Default value is 100 records.
+      # @param created_after [String] Purchase orders that became available after this time will be included in the
       #   result. Must be in ISO-8601 date/time format.
-      # @param [String] created_before Purchase orders that became available before this time will be included in the
+      # @param created_before [String] Purchase orders that became available before this time will be included in the
       #   result. Must be in ISO-8601 date/time format.
-      # @param [String] sort_order Sort in ascending or descending order by purchase order creation date.
-      # @param [String] next_token Used for pagination when there is more purchase orders than the specified result size
+      # @param sort_order [String] Sort in ascending or descending order by purchase order creation date.
+      # @param next_token [String] Used for pagination when there is more purchase orders than the specified result size
       #   limit. The token value is returned in the previous API call
-      # @param [String] include_details When true, returns purchase orders with complete details. Otherwise, only
+      # @param include_details [String] When true, returns purchase orders with complete details. Otherwise, only
       #   purchase order numbers are returned. Default value is true.
-      # @param [String] changed_after Purchase orders that changed after this timestamp will be included in the result.
+      # @param changed_after [String] Purchase orders that changed after this timestamp will be included in the result.
       #   Must be in ISO-8601 date/time format.
-      # @param [String] changed_before Purchase orders that changed before this timestamp will be included in the
+      # @param changed_before [String] Purchase orders that changed before this timestamp will be included in the
       #   result. Must be in ISO-8601 date/time format.
-      # @param [String] po_item_state Current state of the purchase order item. If this value is Cancelled, this API
+      # @param po_item_state [String] Current state of the purchase order item. If this value is Cancelled, this API
       #   will return purchase orders which have one or more items cancelled by Amazon with updated item quantity as
       #   zero.
-      # @param [String] is_po_changed When true, returns purchase orders which were modified after the order was placed.
+      # @param is_po_changed [String] When true, returns purchase orders which were modified after the order was placed.
       #   Vendors are required to pull the changed purchase order and fulfill the updated purchase order and not the
       #   original one. Default value is false.
-      # @param [String] purchase_order_state Filters purchase orders based on the purchase order state.
-      # @param [String] ordering_vendor_code Filters purchase orders based on the specified ordering vendor code. This
+      # @param purchase_order_state [String] Filters purchase orders based on the purchase order state.
+      # @param ordering_vendor_code [String] Filters purchase orders based on the specified ordering vendor code. This
       #   value should be same as 'sellingParty.partyId' in the purchase order. If not included in the filter, all
       #   purchase orders for all of the vendor codes that exist in the vendor group used to authorize the API client
       #   application are returned.
+      # @param rate_limit [Float] Requests per second
       # @return [Hash] The API response
-      def get_purchase_orders(
-        limit: nil, created_after: nil, created_before: nil, sort_order: nil, next_token: nil, include_details: nil,
-        changed_after: nil, changed_before: nil, po_item_state: nil, is_po_changed: nil, purchase_order_state: nil,
-        ordering_vendor_code: nil
-      )
+      def get_purchase_orders(limit: nil, created_after: nil, created_before: nil, sort_order: nil, next_token: nil,
+        include_details: nil, changed_after: nil, changed_before: nil, po_item_state: nil, is_po_changed: nil,
+        purchase_order_state: nil, ordering_vendor_code: nil, rate_limit: 10.0)
         path = "/vendor/orders/v1/purchaseOrders"
         params = {
           "limit" => limit,
@@ -61,69 +67,74 @@ module Peddler
           "orderingVendorCode" => ordering_vendor_code,
         }.compact
 
-        rate_limit(10.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Returns a purchase order based on the `purchaseOrderNumber` value that you specify.
       #
-      # @param [String] purchase_order_number The purchase order identifier for the order that you want. Formatting
+      # @note This operation can make a static sandbox call.
+      # @param purchase_order_number [String] The purchase order identifier for the order that you want. Formatting
       #   Notes: 8-character alpha-numeric code.
+      # @param rate_limit [Float] Requests per second
       # @return [Hash] The API response
-      def get_purchase_order(purchase_order_number)
+      def get_purchase_order(purchase_order_number, rate_limit: 10.0)
         path = "/vendor/orders/v1/purchaseOrders/#{purchase_order_number}"
 
-        rate_limit(10.0).get(path)
+        meter(rate_limit).get(path)
       end
 
       # Submits acknowledgements for one or more purchase orders.
       #
-      # @param [Hash] body
+      # @note This operation can make a static sandbox call.
+      # @param body [Hash]
+      # @param rate_limit [Float] Requests per second
       # @return [Hash] The API response
-      def submit_acknowledgement(body)
+      def submit_acknowledgement(body, rate_limit: 10.0)
         path = "/vendor/orders/v1/acknowledgements"
 
-        rate_limit(10.0).post(path, body:)
+        meter(rate_limit).post(path, body:)
       end
 
       # Returns purchase order statuses based on the filters that you specify. Date range to search must not be more
       # than 7 days. You can return a list of purchase order statuses using the available filters, or a single purchase
       # order status by providing the purchase order number.
       #
-      # @param [Integer] limit The limit to the number of records returned. Default value is 100 records.
-      # @param [String] sort_order Sort in ascending or descending order by purchase order creation date.
-      # @param [String] next_token Used for pagination when there are more purchase orders than the specified result
+      # @note This operation can make a static sandbox call.
+      # @param limit [Integer] The limit to the number of records returned. Default value is 100 records.
+      # @param sort_order [String] Sort in ascending or descending order by purchase order creation date.
+      # @param next_token [String] Used for pagination when there are more purchase orders than the specified result
       #   size limit.
-      # @param [String] created_after Purchase orders that became available after this timestamp will be included in the
+      # @param created_after [String] Purchase orders that became available after this timestamp will be included in the
       #   result. Must be in ISO-8601 date/time format.
-      # @param [String] created_before Purchase orders that became available before this timestamp will be included in
+      # @param created_before [String] Purchase orders that became available before this timestamp will be included in
       #   the result. Must be in ISO-8601 date/time format.
-      # @param [String] updated_after Purchase orders for which the last purchase order update happened after this
+      # @param updated_after [String] Purchase orders for which the last purchase order update happened after this
       #   timestamp will be included in the result. Must be in ISO-8601 date/time format.
-      # @param [String] updated_before Purchase orders for which the last purchase order update happened before this
+      # @param updated_before [String] Purchase orders for which the last purchase order update happened before this
       #   timestamp will be included in the result. Must be in ISO-8601 date/time format.
-      # @param [String] purchase_order_number Provides purchase order status for the specified purchase order number.
-      # @param [String] purchase_order_status Filters purchase orders based on the specified purchase order status. If
+      # @param purchase_order_number [String] Provides purchase order status for the specified purchase order number.
+      # @param purchase_order_status [String] Filters purchase orders based on the specified purchase order status. If
       #   not included in filter, this will return purchase orders for all statuses.
-      # @param [String] item_confirmation_status Filters purchase orders based on their item confirmation status. If the
+      # @param item_confirmation_status [String] Filters purchase orders based on their item confirmation status. If the
       #   item confirmation status is not included in the filter, purchase orders for all confirmation statuses are
       #   included.
-      # @param [String] item_receive_status Filters purchase orders based on the purchase order's item receive status.
+      # @param item_receive_status [String] Filters purchase orders based on the purchase order's item receive status.
       #   If the item receive status is not included in the filter, purchase orders for all receive statuses are
       #   included.
-      # @param [String] ordering_vendor_code Filters purchase orders based on the specified ordering vendor code. This
+      # @param ordering_vendor_code [String] Filters purchase orders based on the specified ordering vendor code. This
       #   value should be same as 'sellingParty.partyId' in the purchase order. If not included in filter, all purchase
       #   orders for all the vendor codes that exist in the vendor group used to authorize API client application are
       #   returned.
-      # @param [String] ship_to_party_id Filters purchase orders for a specific buyer's Fulfillment Center/warehouse by
+      # @param ship_to_party_id [String] Filters purchase orders for a specific buyer's Fulfillment Center/warehouse by
       #   providing ship to location id here. This value should be same as 'shipToParty.partyId' in the purchase order.
       #   If not included in filter, this will return purchase orders for all the buyer's warehouses used for vendor
       #   group purchase orders.
+      # @param rate_limit [Float] Requests per second
       # @return [Hash] The API response
-      def get_purchase_orders_status(
-        limit: nil, sort_order: nil, next_token: nil, created_after: nil, created_before: nil, updated_after: nil,
-        updated_before: nil, purchase_order_number: nil, purchase_order_status: nil, item_confirmation_status: nil,
-        item_receive_status: nil, ordering_vendor_code: nil, ship_to_party_id: nil
-      )
+      def get_purchase_orders_status(limit: nil, sort_order: nil, next_token: nil, created_after: nil,
+        created_before: nil, updated_after: nil, updated_before: nil, purchase_order_number: nil,
+        purchase_order_status: nil, item_confirmation_status: nil, item_receive_status: nil, ordering_vendor_code: nil,
+        ship_to_party_id: nil, rate_limit: 10.0)
         path = "/vendor/orders/v1/purchaseOrdersStatus"
         params = {
           "limit" => limit,
@@ -141,7 +152,7 @@ module Peddler
           "shipToPartyId" => ship_to_party_id,
         }.compact
 
-        rate_limit(10.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
     end
   end

data/lib/peddler/api/vendor_shipments_v1.rb

@@ -3,6 +3,12 @@
 require "peddler/api"
 
 module Peddler
+  class << self
+    def vendor_shipments_v1(...)
+      API::VendorShipmentsV1.new(...)
+    end
+  end
+
   class API
     # Selling Partner API for Retail Procurement Shipments
     #
@@ -11,80 +17,86 @@ module Peddler
     class VendorShipmentsV1 < API
       # Submits one or more shipment confirmations for vendor orders.
       #
-      # @param [Hash] body A request to submit shipment confirmation.
+      # @note This operation can make a static sandbox call.
+      # @param body [Hash] A request to submit shipment confirmation.
+      # @param rate_limit [Float] Requests per second
       # @return [Hash] The API response
-      def submit_shipment_confirmations(body)
+      def submit_shipment_confirmations(body, rate_limit: 10.0)
         path = "/vendor/shipping/v1/shipmentConfirmations"
 
-        rate_limit(10.0).post(path, body:)
+        meter(rate_limit).post(path, body:)
       end
 
       # Submits one or more shipment request for vendor Orders.
       #
-      # @param [Hash] body A request to submit shipment request.
+      # @param body [Hash] A request to submit shipment request.
+      # @param rate_limit [Float] Requests per second
       # @return [Hash] The API response
-      def submit_shipments(body)
+      def submit_shipments(body, rate_limit: 10.0)
+        cannot_sandbox!
+
         path = "/vendor/shipping/v1/shipments"
 
-        rate_limit(10.0).post(path, body:)
+        meter(rate_limit).post(path, body:)
       end
 
       # Returns the Details about Shipment, Carrier Details, status of the shipment, container details and other details
       # related to shipment based on the filter parameters value that you specify.
       #
-      # @param [Integer] limit The limit to the number of records returned. Default value is 50 records.
-      # @param [String] sort_order Sort in ascending or descending order by purchase order creation date.
-      # @param [String] next_token Used for pagination when there are more shipments than the specified result size
+      # @param limit [Integer] The limit to the number of records returned. Default value is 50 records.
+      # @param sort_order [String] Sort in ascending or descending order by purchase order creation date.
+      # @param next_token [String] Used for pagination when there are more shipments than the specified result size
       #   limit.
-      # @param [String] created_after Get Shipment Details that became available after this timestamp will be included
-      #   in the result. Must be in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.
-      # @param [String] created_before Get Shipment Details that became available before this timestamp will be included
-      #   in the result. Must be in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.
-      # @param [String] shipment_confirmed_before Get Shipment Details by passing Shipment confirmed create Date Before.
-      #   Must be in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.
-      # @param [String] shipment_confirmed_after Get Shipment Details by passing Shipment confirmed create Date After.
-      #   Must be in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.
-      # @param [String] package_label_created_before Get Shipment Details by passing Package label create Date by buyer.
-      #   Must be in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.
-      # @param [String] package_label_created_after Get Shipment Details by passing Package label create Date After by
-      #   buyer. Must be in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.
-      # @param [String] shipped_before Get Shipment Details by passing Shipped Date Before. Must be in [ISO
-      #   8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.
-      # @param [String] shipped_after Get Shipment Details by passing Shipped Date After. Must be in [ISO
-      #   8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.
-      # @param [String] estimated_delivery_before Get Shipment Details by passing Estimated Delivery Date Before. Must
-      #   be in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.
-      # @param [String] estimated_delivery_after Get Shipment Details by passing Estimated Delivery Date Before. Must be
-      #   in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.
-      # @param [String] shipment_delivery_before Get Shipment Details by passing Shipment Delivery Date Before. Must be
-      #   in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.
-      # @param [String] shipment_delivery_after Get Shipment Details by passing Shipment Delivery Date After. Must be in
-      #   [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.
-      # @param [String] requested_pick_up_before Get Shipment Details by passing Before Requested pickup date. Must be
-      #   in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.
-      # @param [String] requested_pick_up_after Get Shipment Details by passing After Requested pickup date. Must be in
-      #   [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.
-      # @param [String] scheduled_pick_up_before Get Shipment Details by passing Before scheduled pickup date. Must be
-      #   in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.
-      # @param [String] scheduled_pick_up_after Get Shipment Details by passing After Scheduled pickup date. Must be in
-      #   [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.
-      # @param [String] current_shipment_status Get Shipment Details by passing Current shipment status.
-      # @param [String] vendor_shipment_identifier Get Shipment Details by passing Vendor Shipment ID
-      # @param [String] buyer_reference_number Get Shipment Details by passing buyer Reference ID
-      # @param [String] buyer_warehouse_code Get Shipping Details based on buyer warehouse code. This value should be
+      # @param created_after [String] Get Shipment Details that became available after this timestamp will be included
+      #   in the result. Must be in {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} format.
+      # @param created_before [String] Get Shipment Details that became available before this timestamp will be included
+      #   in the result. Must be in {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} format.
+      # @param shipment_confirmed_before [String] Get Shipment Details by passing Shipment confirmed create Date Before.
+      #   Must be in {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} format.
+      # @param shipment_confirmed_after [String] Get Shipment Details by passing Shipment confirmed create Date After.
+      #   Must be in {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} format.
+      # @param package_label_created_before [String] Get Shipment Details by passing Package label create Date by buyer.
+      #   Must be in {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} format.
+      # @param package_label_created_after [String] Get Shipment Details by passing Package label create Date After by
+      #   buyer. Must be in {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} format.
+      # @param shipped_before [String] Get Shipment Details by passing Shipped Date Before. Must be in
+      #   {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} format.
+      # @param shipped_after [String] Get Shipment Details by passing Shipped Date After. Must be in
+      #   {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} format.
+      # @param estimated_delivery_before [String] Get Shipment Details by passing Estimated Delivery Date Before. Must
+      #   be in {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} format.
+      # @param estimated_delivery_after [String] Get Shipment Details by passing Estimated Delivery Date Before. Must be
+      #   in {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} format.
+      # @param shipment_delivery_before [String] Get Shipment Details by passing Shipment Delivery Date Before. Must be
+      #   in {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} format.
+      # @param shipment_delivery_after [String] Get Shipment Details by passing Shipment Delivery Date After. Must be in
+      #   {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} format.
+      # @param requested_pick_up_before [String] Get Shipment Details by passing Before Requested pickup date. Must be
+      #   in {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} format.
+      # @param requested_pick_up_after [String] Get Shipment Details by passing After Requested pickup date. Must be in
+      #   {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} format.
+      # @param scheduled_pick_up_before [String] Get Shipment Details by passing Before scheduled pickup date. Must be
+      #   in {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} format.
+      # @param scheduled_pick_up_after [String] Get Shipment Details by passing After Scheduled pickup date. Must be in
+      #   {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} format.
+      # @param current_shipment_status [String] Get Shipment Details by passing Current shipment status.
+      # @param vendor_shipment_identifier [String] Get Shipment Details by passing Vendor Shipment ID
+      # @param buyer_reference_number [String] Get Shipment Details by passing buyer Reference ID
+      # @param buyer_warehouse_code [String] Get Shipping Details based on buyer warehouse code. This value should be
       #   same as 'shipToParty.partyId' in the Shipment.
-      # @param [String] seller_warehouse_code Get Shipping Details based on vendor warehouse code. This value should be
+      # @param seller_warehouse_code [String] Get Shipping Details based on vendor warehouse code. This value should be
       #   same as 'sellingParty.partyId' in the Shipment.
+      # @param rate_limit [Float] Requests per second
       # @return [Hash] The API response
-      def get_shipment_details(
-        limit: nil, sort_order: nil, next_token: nil, created_after: nil, created_before: nil,
+      def get_shipment_details(limit: nil, sort_order: nil, next_token: nil, created_after: nil, created_before: nil,
         shipment_confirmed_before: nil, shipment_confirmed_after: nil, package_label_created_before: nil,
         package_label_created_after: nil, shipped_before: nil, shipped_after: nil, estimated_delivery_before: nil,
         estimated_delivery_after: nil, shipment_delivery_before: nil, shipment_delivery_after: nil,
         requested_pick_up_before: nil, requested_pick_up_after: nil, scheduled_pick_up_before: nil,
         scheduled_pick_up_after: nil, current_shipment_status: nil, vendor_shipment_identifier: nil,
-        buyer_reference_number: nil, buyer_warehouse_code: nil, seller_warehouse_code: nil
-      )
+        buyer_reference_number: nil, buyer_warehouse_code: nil, seller_warehouse_code: nil, rate_limit: 10.0)
+        cannot_sandbox!
+
         path = "/vendor/shipping/v1/shipments"
         params = {
           "limit" => limit,
@@ -113,7 +125,7 @@ module Peddler
           "sellerWarehouseCode" => seller_warehouse_code,
         }.compact
 
-        rate_limit(10.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
     end
   end

data/lib/peddler/api/vendor_transaction_status_v1.rb

@@ -3,6 +3,12 @@
 require "peddler/api"
 
 module Peddler
+  class << self
+    def vendor_transaction_status_v1(...)
+      API::VendorTransactionStatusV1.new(...)
+    end
+  end
+
   class API
     # Selling Partner API for Retail Procurement Transaction Status
     #
@@ -11,13 +17,16 @@ module Peddler
     class VendorTransactionStatusV1 < API
       # Returns the status of the transaction that you specify.
       #
-      # @param [String] transaction_id The GUID provided by Amazon in the 'transactionId' field in response to the post
+      # @param transaction_id [String] The GUID provided by Amazon in the 'transactionId' field in response to the post
       #   request of a specific transaction.
+      # @param rate_limit [Float] Requests per second
       # @return [Hash] The API response
-      def get_transaction(transaction_id)
+      def get_transaction(transaction_id, rate_limit: 10.0)
+        cannot_sandbox!
+
         path = "/vendor/transactions/v1/transactions/#{transaction_id}"
 
-        rate_limit(10.0).get(path)
+        meter(rate_limit).get(path)
       end
     end
   end

data/lib/peddler/api.rb

@@ -2,14 +2,18 @@
 
 require "http"
 
+require "peddler/endpoint"
 require "peddler/error"
-require "peddler/region"
+require "peddler/version"
 
 module Peddler
   # Wraps an Amazon Selling Partner API (SP-API)
   class API
-    # @return [Peddler::Region]
-    attr_reader :region
+    class CannotSandbox < StandardError; end
+    class MustSandbox < StandardError; end
+
+    # @return [Peddler::Endpoint]
+    attr_reader :endpoint
 
     # @return [String]
     attr_reader :access_token
@@ -17,41 +21,60 @@ module Peddler
     # @param [String] aws_region
     # @param [String] access_token
     def initialize(aws_region, access_token)
-      @region = Region.new(aws_region)
+      @endpoint = Endpoint.find(aws_region)
       @access_token = access_token
+      @sandbox = false
     end
 
-    def endpoint
-      @endpoint ||= region.endpoint
+    # @return [URI::HTTPS]
+    def endpoint_uri
+      sandbox? ? endpoint.sandbox : endpoint.production
     end
 
     # @see https://developer-docs.amazon.com/sp-api/docs/the-selling-partner-api-sandbox
     # @return [self]
     def sandbox
-      @endpoint = endpoint.sub(/(?:sandbox.)?sellingpartnerapi/, "sandbox.sellingpartnerapi")
+      @sandbox = true
       self
     end
 
+    # @return [Boolean]
+    def sandbox?
+      @sandbox
+    end
+
+    # @raise [CannotSandbox] if in a sandbox environment
+    def cannot_sandbox!
+      raise CannotSandbox, "cannot run in a sandbox" if sandbox?
+    end
+
+    # @raise [MustSandbox] unless in a sandbox environment
+    def must_sandbox!
+      raise MustSandbox, "must run in a sandbox" unless sandbox?
+    end
+
     # @see https://developer-docs.amazon.com/sp-api/docs/include-a-user-agent-header-in-all-requests
     # @see https://developer-docs.amazon.com/amazon-shipping/docs/connecting-to-the-selling-partner-api#step-3-add-headers-to-the-uri
     # @return [HTTP::Client]
     def http
       @http ||= HTTP.headers(
-        "Host" => endpoint_host,
+        "Host" => endpoint_uri.host,
         "User-Agent" => user_agent,
         "X-Amz-Access-Token" => access_token,
         "X-Amz-Date" => timestamp,
       )
     end
 
-    # Retries with a rate limit when the API returns a 429
+    # Throttles with a rate limit and retries when the API returns a 429
     #
-    # @param [Float] delay The delay in seconds before retrying
+    # @param [Float] rate_limit The delay in seconds before retrying
     # @return [self]
-    def rate_limit(rate)
-      # HTTP v6.0 will implement retriable
+    def meter(rate_limit)
+      # HTTP v6.0 will implement retriable. Until then, point to their GitHub repo, or it's a no-op.
       # https://github.com/httprb/http/pull/790
-      retriable(delay: 1.0 / rate, retry_statuses: [429]) if @http.respond_to?(:retriable)
+      delay = sandbox? ? 0.2 : 1.0 / rate_limit
+      retriable(delay: delay, retry_statuses: [429]) if @http.respond_to?(:retriable)
+
       self
     end
 
@@ -87,7 +110,11 @@ module Peddler
           options[:json] = options.delete(:body)
         end
 
-        response = http.send(method, [endpoint, path].join, **options)
+        uri = endpoint_uri.tap do |uri|
+          uri.path = path
+        end
+
+        response = http.send(method, uri, **options)
 
         if response.status.client_error?
           error = Error.build(response)
@@ -100,10 +127,6 @@ module Peddler
 
     private
 
-    def endpoint_host
-      URI.parse(endpoint).host
-    end
-
     def user_agent
       "Peddler/#{Peddler::VERSION} (Language=Ruby; #{Socket.gethostname})"
     end

data/lib/peddler/endpoint.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module Peddler
+  # @see https://developer-docs.amazon.com/sp-api/docs/sp-api-endpoints
+  ENDPOINTS = {
+    "us-east-1" => {
+      selling_region: "North America",
+      host: "sellingpartnerapi-na.amazon.com",
+    },
+    "us-west-2" => {
+      selling_region: "Far East",
+      host: "sellingpartnerapi-fe.amazon.com",
+    },
+    "eu-west-1" => {
+      selling_region: "Europe",
+      host: "sellingpartnerapi-eu.amazon.com",
+    },
+  }
+
+  Endpoint = Data.define(:aws_region, :selling_region, :host) do
+    class << self
+      # @param [String] aws_region
+      def find(aws_region)
+        values = ENDPOINTS.fetch(aws_region) do
+          raise ArgumentError, "#{aws_region} not found"
+        end
+
+        new(**values.merge(aws_region: aws_region))
+      end
+
+      def find_by_selling_region(selling_region)
+        aws_region, values = ENDPOINTS.find { |_, v| v[:selling_region] == selling_region } ||
+          raise(ArgumentError, "#{selling_region} not found")
+
+        new(**values.merge(aws_region: aws_region))
+      end
+    end
+
+    # @return [URI]
+    def production
+      URI::HTTPS.build(host: host)
+    end
+
+    # @return [URI]
+    def sandbox
+      URI::HTTPS.build(host: "sandbox.#{host}")
+    end
+  end
+end

data/lib/peddler/error.rb

@@ -3,6 +3,7 @@
 module Peddler
   class Error < StandardError
     class InvalidInput < Error; end
+    class NotFound < Error; end
     class QuotaExceeded < Error; end
     class Unauthorized < Error; end
 

data/lib/peddler/marketplace.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+require "peddler/endpoint"
+
+module Peddler
+  # @see https://developer-docs.amazon.com/sp-api/docs/marketplace-ids
+  MARKETPLACE_IDS = {
+    "CA" => { id: "A2EUQ1WTGCTBG2", country_name: "Canada", selling_region: "North America" },
+    "US" => { id: "ATVPDKIKX0DER", country_name: "United States", selling_region: "North America" },
+    "MX" => { id: "A1AM78C64UM0Y8", country_name: "Mexico", selling_region: "North America" },
+    "BR" => { id: "A2Q3Y263D00KWC", country_name: "Brazil", selling_region: "North America" },
+    "ES" => { id: "A1RKKUPIHCS9HS", country_name: "Spain", selling_region: "Europe" },
+    "UK" => { id: "A1F83G8C2ARO7P", country_name: "United Kingdom", selling_region: "Europe" },
+    "FR" => { id: "A13V1IB3VIYZZH", country_name: "France", selling_region: "Europe" },
+    "BE" => { id: "AMEN7PMS3EDWL", country_name: "Belgium", selling_region: "Europe" },
+    "NL" => { id: "A1805IZSGTT6HS", country_name: "Netherlands", selling_region: "Europe" },
+    "DE" => { id: "A1PA6795UKMFR9", country_name: "Germany", selling_region: "Europe" },
+    "IT" => { id: "APJ6JRA9NG5V4", country_name: "Italy", selling_region: "Europe" },
+    "SE" => { id: "A2NODRKZP88ZB9", country_name: "Sweden", selling_region: "Europe" },
+    "ZA" => { id: "AE08WJ6YKNBMC", country_name: "South Africa", selling_region: "Europe" },
+    "PL" => { id: "A1C3SOZRARQ6R3", country_name: "Poland", selling_region: "Europe" },
+    "EG" => { id: "ARBP9OOSHTCHU", country_name: "Egypt", selling_region: "Europe" },
+    "TR" => { id: "A33AVAJ2PDY3EV", country_name: "Turkey", selling_region: "Europe" },
+    "SA" => { id: "A17E79C6D8DWNP", country_name: "Saudi Arabia", selling_region: "Europe" },
+    "AE" => { id: "A2VIGQ35RCS4UG", country_name: "United Arab Emirates", selling_region: "Europe" },
+    "IN" => { id: "A21TJRUUN4KGV", country_name: "India", selling_region: "Europe" },
+    "SG" => { id: "A19VAU5U5O7RUS", country_name: "Singapore", selling_region: "Far East" },
+    "AU" => { id: "A39IBJ37TRP1C6", country_name: "Australia", selling_region: "Far East" },
+    "JP" => { id: "A1VC38T7YXB528", country_name: "Japan", selling_region: "Far East" },
+  }
+
+  Marketplace = Data.define(:id, :country_code, :country_name, :selling_region) do
+    class << self
+      # @param [String] country_code
+      def find(country_code)
+        values = MARKETPLACE_IDS.fetch(country_code) do
+          raise ArgumentError, "#{country_code} not found"
+        end
+
+        new(**values.merge(country_code: country_code))
+      end
+    end
+
+    # @return [Peddler::Endpoint]
+    def endpoint
+      Endpoint.find_by_selling_region(selling_region)
+    end
+  end
+end