Amazon Services China
亚马逊商城网络服务(亚马逊 MWS)文档

Deprecation Notice:

Amazon Marketplace Web Service (MWS) will no longer be available after March 31, 2024. All MWS developers must migrate to Selling Partner API (SP-API) to avoid service disruptions. Refer to the Migration Hub for more information.

亚马逊 MWS 文档

ListOrderItemsByNextToken

使用 NextToken 参数返回下一页订单商品。

描述

ListOrderItemsByNextToken 操作返回订单商品的下一页信息,通过使用 NextToken 的值来完成此操作,该值是通过您上一步请求 ListOrderItemsListOrderItemsByNextToken来进行返回。如果未返回 NextToken 的值,则不会返回其他页面。

ListOrderItemsListOrderItemsByNextToken 操作共享的 最大请求限额为 30 个,恢复速率为每 2 秒钟 1 个请求。有关限制术语的相关定义,请参阅您应了解的“订单 API”部分的相关内容

请求参数

名称 描述 必填项 有效值
NextToken 您之前对 ListOrderItemsListOrderItemsByNextToken的请求的响应中返回的字符串标记。 类型:xs:string

响应元素

名称 描述
NextToken 生成的字符串,用于将信息传递给下一请求。如果返回 NextToken,将 NextToken 的值传递给 ListOrderItemsByNextToken。如果没有返回 NextToken,则不返回其他订单商品。

可选项

类型:xs:string

AmazonOrderId 亚马逊所定义的订单编码,格式 为 3-7-7。

类型:xs:string

OrderItems 订单商品列表。

类型:OrderItem 列表

示例

查询请求示例

https://mws.amazonservices.com/Orders/2013-09-01
  ?AWSAccessKeyId=0PB842EXAMPLE7N4ZTR2
  &Action=ListOrderItemsByNextToken
  &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
  &SellerId=A1XEXAMPLE5E6
  &NextToken=MRgZW55IGNhcm5hbCBwbGVhc3VyZS6%3D
  &Signature=ZQLpf8vEXAMPLE0iC265pf18n0%3D
  &SignatureVersion=2
  &SignatureMethod=HmacSHA256
  &Timestamp=2013-09-05T18%3A12%3A21.687Z
  &Version=2013-09-01

示例响应

<?xml version="1.0" encoding="utf-8"?>
  <ListOrderItemsByNextTokenResponse xmlns="https://mws.amazonservices.com
  /Orders/2013-09-01">
    <ListOrderItemsByNextTokenResult>
      <NextToken>MRgZW55IGNhcm5hbCBwbGVhc3VyZS6=</NextToken>
      <AmazonOrderId>058-1233752-8214740</AmazonOrderId>
      <OrderItems>
        <OrderItem>
          <ASIN>BT0093TELA</ASIN>
          <OrderItemId>68828574383266</OrderItemId>
          <SellerSKU>CBA_OTF_1</SellerSKU>
          <Title>Example item name</Title>
          <QuantityOrdered>1</QuantityOrdered>
          <QuantityShipped>1</QuantityShipped>
          <ItemPrice>
            <CurrencyCode>USD</CurrencyCode>
            <Amount>25.99</Amount>
          </ItemPrice>
          <ShippingPrice>
            <CurrencyCode>USD</CurrencyCode>
            <Amount>1.26</Amount>
          </ShippingPrice>
          <ScheduledDeliveryEndDate>2013-09-091T01:30:00.000-06:00
          </ScheduledDeliveryEndDate>
          <ScheduledDeliveryStartDate>2013-09-06T02:00:00.000-06:00
          </ScheduledDeliveryStartDate>
          <CODFee>
            <CurrencyCode>USD</CurrencyCode>
            <Amount>10.00</Amount>
          </CODFee>
          <CODFeeDiscount>
            <CurrencyCode>USD</CurrencyCode>
            <Amount>1.00</Amount>
          </CODFeeDiscount>   
          <GiftMessageText>For you!</GiftMessageText>
          <GiftWrapPrice>
            <CurrencyCode>USD</CurrencyCode>
            <Amount>1.99</Amount>
          </GiftWrapPrice>
          <GiftWrapLevel>Classic</GiftWrapLevel>
        </OrderItem>
        <OrderItem>
          <ASIN>BCTU1104UEFB</ASIN>
          <OrderItemId>79039765272157</OrderItemId>
          <SellerSKU>CBA_OTF_5</SellerSKU>
          <Title>Example item name</Title>
          <QuantityOrdered>2</QuantityOrdered>
          <ItemPrice>
            <CurrencyCode>USD</CurrencyCode>
            <Amount>17.95</Amount>
          </ItemPrice>
          <PromotionIds>
            <PromotionId>FREESHIP</PromotionId>
          </PromotionIds>
          <ConditionId>Used</ConditionId>
          <ConditionSubtypeId>Mint</ConditionSubtypeId>
          <ConditionNote>Example ConditionNote</ConditionNote>          
        </OrderItem>
      </OrderItems>
    </ListOrderItemsByNextTokenResult>
    <ResponseMetadata>
      <RequestId>88faca76-b600-46d2-b53c-0c8c4533e43a</RequestId>
    </ResponseMetadata>
  </ListOrderItemsByNextTokenResponse>