Class: Peddler::APIs::ShippingV1

Inherits:
Peddler::API show all
Defined in:
lib/peddler/apis/shipping_v1.rb

Overview

Selling Partner API for Shipping

Provides programmatic access to Amazon Shipping APIs.

Note: If you are new to the Amazon Shipping API, refer to the latest version of Amazon Shipping API (v2) on the / Amazon Shipping Developer Documentation site.

See Also:

Instance Attribute Summary

Attributes inherited from Peddler::API

#access_token, #endpoint, #retries

Instance Method Summary collapse

Methods inherited from Peddler::API

#endpoint_uri, #http, #initialize, #meter, #retriable, #sandbox, #sandbox?, #typed, #typed?, #use, #via

Constructor Details

This class inherits a constructor from Peddler::API

Instance Method Details

#cancel_shipment(shipment_id, rate_limit: 5.0) ⇒ Peddler::Response

Note:

This operation can make a static sandbox call.

Cancel a shipment by the given shipmentId.

Parameters:

  • shipment_id (String) —

    Shipment Id to cancel a shipment

  • rate_limit (Float) (defaults to: 5.0) —

    Requests per second

Returns:



55
56
57
58
59
 
# File 'lib/peddler/apis/shipping_v1.rb', line 55

def cancel_shipment(shipment_id, rate_limit: 5.0)
  path = "/shipping/v1/shipments/#{percent_encode(shipment_id)}/cancel"
  parser = Peddler::Types::ShippingV1::CancelShipmentResponse if typed?
  meter(rate_limit).post(path, parser:)
end

#create_shipment(body, rate_limit: 5.0) ⇒ Peddler::Response

Note:

This operation can make a static sandbox call.

Create a new shipment.

Parameters:

  • body (Hash) —

    CreateShipmentRequest Body

  • rate_limit (Float) (defaults to: 5.0) —

    Requests per second

Returns:



31
32
33
34
35
 
# File 'lib/peddler/apis/shipping_v1.rb', line 31

def create_shipment(body, rate_limit: 5.0)
  path = "/shipping/v1/shipments"
  parser = Peddler::Types::ShippingV1::CreateShipmentResponse if typed?
  meter(rate_limit).post(path, body:, parser:)
end

#get_account(rate_limit: 5.0) ⇒ Peddler::Response

Note:

This operation can make a static sandbox call.

Verify if the current account is valid.

Parameters:

  • rate_limit (Float) (defaults to: 5.0) —

    Requests per second

Returns:



117
118
119
120
121
 
# File 'lib/peddler/apis/shipping_v1.rb', line 117

def (rate_limit: 5.0)
  path = "/shipping/v1/account"
  parser = Peddler::Types::ShippingV1::GetAccountResponse if typed?
  meter(rate_limit).get(path, parser:)
end

#get_rates(body, rate_limit: 5.0) ⇒ Peddler::Response

Note:

This operation can make a dynamic sandbox call.

Get service rates.

Parameters:

  • body (Hash) —

    GetRatesRequest body

  • rate_limit (Float) (defaults to: 5.0) —

    Requests per second

Returns:



106
107
108
109
110
 
# File 'lib/peddler/apis/shipping_v1.rb', line 106

def get_rates(body, rate_limit: 5.0)
  path = "/shipping/v1/rates"
  parser = Peddler::Types::ShippingV1::GetRatesResponse if typed?
  meter(rate_limit).post(path, body:, parser:)
end

#get_shipment(shipment_id, rate_limit: 5.0) ⇒ Peddler::Response

Note:

This operation can make a static sandbox call.

Return the entire shipment object for the shipmentId.

Parameters:

  • shipment_id (String) —

    Shipment id to return the entire shipment object

  • rate_limit (Float) (defaults to: 5.0) —

    Requests per second

Returns:



43
44
45
46
47
 
# File 'lib/peddler/apis/shipping_v1.rb', line 43

def get_shipment(shipment_id, rate_limit: 5.0)
  path = "/shipping/v1/shipments/#{percent_encode(shipment_id)}"
  parser = Peddler::Types::ShippingV1::GetShipmentResponse if typed?
  meter(rate_limit).get(path, parser:)
end

#get_tracking_information(tracking_id, rate_limit: 1.0) ⇒ Peddler::Response

Note:

This operation can make a static sandbox call.

Return the tracking information of a shipment.

Parameters:

  • tracking_id (String) —

    Tracking Id

  • rate_limit (Float) (defaults to: 1.0) —

    Requests per second

Returns:



129
130
131
132
133
 
# File 'lib/peddler/apis/shipping_v1.rb', line 129

def get_tracking_information(tracking_id, rate_limit: 1.0)
  path = "/shipping/v1/tracking/#{percent_encode(tracking_id)}"
  parser = Peddler::Types::ShippingV1::GetTrackingInformationResponse if typed?
  meter(rate_limit).get(path, parser:)
end

#purchase_labels(shipment_id, body, rate_limit: 5.0) ⇒ Peddler::Response

Note:

This operation can make a static sandbox call.

Purchase shipping labels based on a given rate.

Parameters:

  • shipment_id (String) —

    Shipment id for purchase shipping label

  • body (Hash) —

    PurchaseShippingLabelRequest body

  • rate_limit (Float) (defaults to: 5.0) —

    Requests per second

Returns:



68
69
70
71
72
 
# File 'lib/peddler/apis/shipping_v1.rb', line 68

def purchase_labels(shipment_id, body, rate_limit: 5.0)
  path = "/shipping/v1/shipments/#{percent_encode(shipment_id)}/purchaseLabels"
  parser = Peddler::Types::ShippingV1::PurchaseLabelsResponse if typed?
  meter(rate_limit).post(path, body:, parser:)
end

#purchase_shipment(body, rate_limit: 5.0) ⇒ Peddler::Response

Note:

This operation can make a static sandbox call.

Purchase shipping labels.

Parameters:

  • body (Hash) —

    PurchaseShipmentRequest body

  • rate_limit (Float) (defaults to: 5.0) —

    Requests per second

Returns:



94
95
96
97
98
 
# File 'lib/peddler/apis/shipping_v1.rb', line 94

def purchase_shipment(body, rate_limit: 5.0)
  path = "/shipping/v1/purchaseShipment"
  parser = Peddler::Types::ShippingV1::PurchaseShipmentResponse if typed?
  meter(rate_limit).post(path, body:, parser:)
end

#retrieve_shipping_label(shipment_id, tracking_id, body, rate_limit: 5.0) ⇒ Peddler::Response

Note:

This operation can make a static sandbox call.

Retrieve shipping label based on the shipment id and tracking id.

Parameters:

  • shipment_id (String) —

    Shipment Id to retreive label

  • tracking_id (String) —

    Tracking Id

  • body (Hash) —

    RetrieveShippingLabelRequest body

  • rate_limit (Float) (defaults to: 5.0) —

    Requests per second

Returns:



82
83
84
85
86
 
# File 'lib/peddler/apis/shipping_v1.rb', line 82

def retrieve_shipping_label(shipment_id, tracking_id, body, rate_limit: 5.0)
  path = "/shipping/v1/shipments/#{percent_encode(shipment_id)}/containers/#{percent_encode(tracking_id)}/label"
  parser = Peddler::Types::ShippingV1::RetrieveShippingLabelResponse if typed?
  meter(rate_limit).post(path, body:, parser:)
end