CartCreateで返された値を他のカート操作で使用する

次のXMLコードは、 CartCreate リクエストに対するレスポンスの一部です。

<CartId>002 2197248 2529608</CartId> 
<HMAC>/WrekkZAPx782xttLFbZqviNUOA=</HMAC> 
<URLEncodedHMAC>%2FWrekkZAPx782xttLFbZqviNUOA%3D</URLEncodedHMAC> 
<PurchaseURL>https://www.amazon.com/gp/cart/aws merge.html?cart id=002 2197248 2529608%26associate id=ws%26hmac=/WrekkZAPx782xttLFbZqviNUOA=%26AWSAccessKeyId=[AWS アクセスキー ID]%26MergeCart=True</PurchaseURL> 
<SubTotal>
  <Amount>2998</Amount> 
  <CurrencyCode>USD</CurrencyCode> 
  <FormattedPrice>$29.98</FormattedPrice> 
</SubTotal>
<CartItems>
  <SubTotal>
    <Amount>2998</Amount> 
    <CurrencyCode>USD</CurrencyCode> 
    <FormattedPrice>$29.98</FormattedPrice> 
  </SubTotal>
  <CartItem>
    <CartItemId>UV3W10T4V7PCZ</CartItemId> 
    <ASIN>B000062TU1</ASIN> 
    <MerchantId>ATVPDKIKX0DER</MerchantId> 
    <SellerId>A2R2RITDJNW1Q6</SellerId> 
    <Quantity>2</Quantity> 
    <Title>Harry Potter and the Sorcerer's Stone (Full Screen Edition) (Harry Potter 1)</Title> 
  <ProductGroup>DVD</ProductGroup> 
  <Price>
    <Amount>1499</Amount> 
    <CurrencyCode>USD</CurrencyCode> 
    <FormattedPrice>$14.99</FormattedPrice> 
  </Price>
  <ItemTotal>
    <Amount>2998</Amount> 
    <CurrencyCode>USD</CurrencyCode> 
    <FormattedPrice>$29.98</FormattedPrice> 
  </ItemTotal>
</CartItem>
</CartItems>

レスポンス内の商品属性の多くは、将来のカートリクエストで使用します。これらの商品属性について次の表で説明します。

属性説明
CartIdリモートショッピングカートを一意に識別する英数字の文字列。この値は、新たに作成したカートに関する全てのカートオペレーションで使用する必要があります。

HMAC

Hash Message Authentication Codeの略です。これは暗号化された英数字の文字列で、リクエストの認証に使われます。この値をURLエンコードしたものを、新たに作成したカートに関する全てのカートオペレーションで使用する必要があります。代わりに、URLEncodedHMAC値を使用することもできます。
URLEncodedHMAC

これは、全ての文字をURL互換形式に変換した HMAC 値です。プラス(+)などの一部の HMAC 文字は、URLと互換性がありません。HMAC は、全てのカート操作に含めた上でURLリクエストの一部となるため、このことは問題となります。The URLEncodedHMAC 値を使用すると、開発者が自分でURLエンコードされた HMAC 値を作成する必要がなくなります。この値は、全てのカートオペレーションで使用する必要があります。

<HMAC>Cw1g4IbVzOtzFkJR/zBj1GNnZMA</HMAC>
<URLEncodedHMAC>Cw1g4IbVzOtzFkJR/zBj1GNnZMA
</URLEncodedHMAC>
PurchaseURL

これは、オーダーパイプラインに移動しカート内の商品を購入する際に、リクエストと同様の役割で送信されるURLです。PurchaseURLにはアソシエイトのタグが含まれます。このURLを使用して購入しないと、アソシエイトは販売による紹介料を受け取ることができません。

<PurchaseURL>https://www.amazon.com/gp/cart/aws-merge.html?cart-id=102-9464231-2184159%26associate-id=ws%26hmac=Cw1g4IbVzOtzFkJR/zBj1GNnZMA=%26AWSAccessKeyId=1VEXAMPLE9C02%26MergeCart=False</PurchaseURL>

CartItemIdカート内の商品を一意に識別する英数字文字列です。 CartCreate を使用してリモートショッピングカートに追加された商品はASIN または OfferListingIdで識別されますが、これらの商品の関連付けはなくなります。代わりに、以降のカートオペレーションリクエストでカート内の商品を参照するには、商品の CartItemId 値を使用する必要があります。