Difference between revisions of "API:Product:get weight"

(Calling)
Line 2: Line 2:
  
 
===Calling===
 
===Calling===
<code php>$api->user->get_username($item_sku);</code>
+
<code php>$api->product->get_weight($item_sku);</code>
<code php>$api->user->get_username(array($item_sku_1, $item_sku_2, ..., $item_sku_n));</code>
+
<code php>$api->product->get_weight(array($item_sku_1, $item_sku_2, ..., $item_sku_n));</code>
  
 
===Parameters===
 
===Parameters===

Revision as of 14:34, 28 May 2009

Retrieves the weight, in ounces, of an item or the sum total of the weight of a collection of items.

Calling

$api->product->get_weight($item_sku); $api->product->get_weight(array($item_sku_1, $item_sku_2, ..., $item_sku_n));

Parameters

$item_sku - The SKU of an item. May also be a list of items in which case the sum weight total of the items is returned.

Returns

The weight, in ounces, of the item or collection of items.

Exceptions

AoPSAPI_Exception::MISSING_PARAMETER - Missing item sku or list of item skus

AoPSAPI_Exception::INVALID_PARAMETER - An invalid item sku was passed in

AoPSAPI_Exception::INVALID_PERMISSIONS - API Application does not have permission to submit order

Example

require_once 'AoPSAPI.php';

$api = new AoPSAPI('<api_key>', '<secret_key>'); try {

   $result = $api->product->get_weight('intro:algebra');
   echo 'The weight of Introduction to Algebra is ' . $result . ' ounces.
';
   $result = $api->product->get_weight(array('intro:algebra', 'intro:algebra:solutions'));
   echo 'The combined weight of Introduction to Algebra and its solutions manual is ' .
        $result . ' ounces.
';

} catch (AoPSAPI_Exception $ex) {

   echo $ex->getMessage() . "
";

}

Output

The weight of Introduction to Algebra is 53 ounces.
The combined weight of Introduction to Algebra and its solutions manual is 79 ounces.