Amazon Product Advertising API, Developer'S Manual

Page: 195 / 484

Response
Description Name
Alphanumeric token returned by CartCreate (p. 175) that identifies a
cart.
CartId
Specifies an item in a cart.
CartItemId
is neither an ASIN nor an
OfferListingId. It is, instead, an alphanumeric token returned by
CartCreate (p. 175) and
CartAdd
. Child of Item.
CartItemId
Hash Message Authentication Code returned by CartCreate (p. 175)
that identifies a cart. This is an encrypted alphanumeric token that is
used to authenticate cart operations.
HMAC
For REST, a prefix for CartItemId and Quantity, both of which are used
to specify the item to be modified, for example,
item.1.CartItemId=1234abcd, item.1.Quantity=2 changes the quantity
of item 1234abcd to 2.
Item
Container for Item when specifying more than one Item.
Items
The suffix used with Item to specify the number of items to be added
to the cart. See Item.
Quantity
For more information about the parent elements of these tags, see the appropriate response group in
Response Groups (p. 213)
Examples
Increase the quantity of an item (Item.1) already in the cart and remove an item (Item.2).
http://webservices.amazon.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId= [AWS Access Key ID] &
AssociateTag= [Associate ID] &
Operation=CartModify&
CartId= [Cart ID] &
HMAC= [HMAC] &
Item.1.CartItemId= [Cart Item ID] &
Item.1.Quantity=10&
Item.2.CartItemId= [Cart Item ID] &
Item.2.Quantity=0
&Timestamp=[YYYY-MM-DDThh:mm:ssZ]
&Signature=[Request Signature]
Notice that items in the cart are referred to by
CartItemId
, not their
ASIN
or
OfferListingId
CartItemId
is returned by
CartCreate
(p. 175) ,
CartGet
(p. 181) , and
CartAdd
(p. 168) . If you want
to use
CartModify
to modify the items in a cart, you must refer to the items using their
CartItemId
.
You use
CartGet
(p. 181) to retrieve the
CartItemId
s.
The response to this request is shown in, Response to Sample Request (p. 167) .
Move an item (Item.1) to the SaveForLater area in the cart and reduce then number of items (Item.2) to
1.
API Version 2011-08-01
188
Product Advertising API Developer Guide
CartModify