Finding Items Using a Customer ID
If you just want to display the items on a list, you can use the URL
returned. If, however, instead of just displaying the list, you want to return the
list item's ASINs and ListItemIds
, which you need to add
the list items to a remote shopping cart, you must use the list ID in a ListLookup request. ListSearch
can only use a few response groups, which means that the information returned about
the items on the list is minimal. ListLookup
, on the other
hand, can use many response groups, which means that you can return a great deal of
information about the items on a list.
To find items using a customer ID
-
Use the
ListId
in aListLookup
request to return list item ASINs andListItemIds
.
The following URL is a sample ListLookup
request.
http://ecs.amazonaws.com/onca/xml? Service=AWSECommerceService& AWSAccessKeyId=[Access Key ID]
Operation=ListLookup
& ListType=WishList& ListId=BB4444444477
Notice that the ListLookup
request requires a ListType
as well as a ListId
because
ListId
are not unique across all lists.
Important | |
---|---|
You must never display customer IDs publicly. You may use them in requests only to look up information. You may associate that information with a customer's name or nickname but never his or her customer ID. |
The following XML shows a snippet of the response.
<ListItem> <ListItemId>98989898989898</ListItemId> <DateAdded>2002-01-27</DateAdded> <QuantityDesired>1</QuantityDesired> <QuantityReceived>0</QuantityReceived> <Item> <ASIN>0865874069</ASIN> <ItemAttributes> <Title>Confined Space Entry : Complying with the Standard</Title> </ItemAttributes> </Item> </ListItem>
Notice that the response includes the ListItemId element. To add a list item to a
remote shopping cart, you must include in the <parameter>CartCreate
</parameter> or <parameter>CartAdd
</parameter> request the item's ASIN and
ListItemId. For more information, see Modifying the Items in a Remote
Shopping Cart.
This response includes only one item attribute, the title of the item. By specifying more response groups in the request, you can return more information about the items on a list.