getListingOffers

返回单个SKU列表中最低价格的优惠。

注意： 与此操作关联的参数可能包含需要进行URL编码的特殊字符，以调用API。为了避免在编码URL时出现SKU错误，请参阅URL编码。

使用计划：

速率（每秒请求数）	突发
1	2

响应头x-amzn-RateLimit-Limit返回对请求操作施加的使用计划速率限制（如果可用）。上表指示此操作的默认速率和突发值。业务需求要求更高吞吐量的销售合作伙伴可能会看到比这里显示的更高的速率和突发值。有关更多信息，请参阅销售合作伙伴API中的使用计划和速率限制。

请求参数

Path 参数

SellerSKU

string

必需

在给定的市场中识别一个项目。SellerSKU由卖家的SellerId验证，SellerId会包含在您提交的每个操作中。

Query 参数

MarketplaceId

string

必需

市场标识符。指定返回价格的市场。

ItemCondition

enum<string>

必需

根据物品状态过滤报价列表。可能的值：全新、二手、收藏品、翻新、俱乐部。

枚举值:

NewUsedCollectibleRefurbishedClub

CustomerType

enum<string>

可选

指示是否请求消费者或商业优惠。默认是消费者。

枚举值:

ConsumerBusiness

返回响应

🟢200成功

application/json

成功。

Headers

x-amzn-RateLimit-Limit

string

可选

您对此操作的速率限制（每秒请求数量）。

x-amzn-RequestId

string

唯一请求参考ID。

可选

Body

`getListingOffers` 和 `getItemOffers` 操作的响应模式。

payload

object (GetOffersResult)

可选

MarketplaceID

string

市场标识符。

必需

ASIN

string

可选

该商品的亚马逊标准识别号码（ASIN）。

SKU

string

可选

该商品的库存单位（SKU）。

ItemCondition

enum<string>

必需

表示物品的状态。可能的值：全新，二手，收藏品，翻新，俱乐部。

枚举值:

NewUsedCollectibleRefurbishedClub

status

string

操作的状态。

必需

Identifier

object (ItemIdentifier)

识别物品的信息。

必需

Summary

object (Summary)

必需

包含有关产品的价格信息，包括最低价格和购物车价格、列表价格、建议的低价格加运费、以及报价数量和符合购物车条件的报价数量。

Offers

array[object (OfferDetail) {16}]

必需

<= 20 items

errors

array[object (Error) {3}]

可选

请求失败时返回的错误响应列表。

code

string

必需

一个标识发生错误类型的错误代码。

message

string

必需

一种以人类可读的形式描述错误状态的消息。

details

string

可选

可以帮助来电者理解或解决问题的额外信息。

示例

{
  "payload": {
    "MarketplaceID": "string",
    "ASIN": "string",
    "SKU": "string",
    "ItemCondition": "New",
    "status": "string",
    "Identifier": {
      "MarketplaceId": "string",
      "ASIN": "string",
      "SellerSKU": "string",
      "ItemCondition": "New"
    },
    "Summary": {
      "TotalOfferCount": 0,
      "NumberOfOffers": [
        {
          "condition": "string",
          "fulfillmentChannel": "Amazon",
          "OfferCount": 0
        }
      ],
      "LowestPrices": [
        {
          "condition": "string",
          "fulfillmentChannel": "string",
          "offerType": "B2C",
          "quantityTier": 0,
          "quantityDiscountType": "QUANTITY_DISCOUNT",
          "LandedPrice": {
            "CurrencyCode": "string",
            "Amount": 0
          },
          "ListingPrice": {
            "CurrencyCode": "string",
            "Amount": 0
          },
          "Shipping": {
            "CurrencyCode": "string",
            "Amount": 0
          },
          "Points": {
            "PointsNumber": 0,
            "PointsMonetaryValue": {
              "CurrencyCode": "string",
              "Amount": 0
            }
          }
        }
      ],
      "BuyBoxPrices": [
        {
          "condition": "string",
          "offerType": "B2C",
          "quantityTier": 0,
          "quantityDiscountType": "QUANTITY_DISCOUNT",
          "LandedPrice": {
            "CurrencyCode": "string",
            "Amount": 0
          },
          "ListingPrice": {
            "CurrencyCode": "string",
            "Amount": 0
          },
          "Shipping": {
            "CurrencyCode": "string",
            "Amount": 0
          },
          "Points": {
            "PointsNumber": 0,
            "PointsMonetaryValue": {
              "CurrencyCode": "string",
              "Amount": 0
            }
          },
          "sellerId": "string"
        }
      ],
      "ListPrice": {
        "CurrencyCode": "string",
        "Amount": 0
      },
      "CompetitivePriceThreshold": {
        "CurrencyCode": "string",
        "Amount": 0
      },
      "SuggestedLowerPricePlusShipping": {
        "CurrencyCode": "string",
        "Amount": 0
      },
      "SalesRankings": [
        {
          "ProductCategoryId": "string",
          "Rank": 0
        }
      ],
      "BuyBoxEligibleOffers": [
        {
          "condition": "string",
          "fulfillmentChannel": "Amazon",
          "OfferCount": 0
        }
      ],
      "OffersAvailableTime": "2019-08-24T14:15:22Z"
    },
    "Offers": [
      {
        "MyOffer": true,
        "offerType": "B2C",
        "SubCondition": "string",
        "SellerId": "string",
        "ConditionNotes": "string",
        "SellerFeedbackRating": {
          "SellerPositiveFeedbackRating": 0,
          "FeedbackCount": 0
        },
        "ShippingTime": {
          "minimumHours": 0,
          "maximumHours": 0,
          "availableDate": "string",
          "availabilityType": "NOW"
        },
        "ListingPrice": {
          "CurrencyCode": "string",
          "Amount": 0
        },
        "quantityDiscountPrices": [
          {
            "quantityTier": 0,
            "quantityDiscountType": "QUANTITY_DISCOUNT",
            "listingPrice": {
              "CurrencyCode": "string",
              "Amount": 0
            }
          }
        ],
        "Points": {
          "PointsNumber": 0,
          "PointsMonetaryValue": {
            "CurrencyCode": "string",
            "Amount": 0
          }
        },
        "Shipping": {
          "CurrencyCode": "string",
          "Amount": 0
        },
        "ShipsFrom": {
          "State": "string",
          "Country": "string"
        },
        "IsFulfilledByAmazon": true,
        "PrimeInformation": {
          "IsPrime": true,
          "IsNationalPrime": true
        },
        "IsBuyBoxWinner": true,
        "IsFeaturedMerchant": true
      }
    ]
  },
  "errors": [
    {
      "code": "string",
      "message": "string",
      "details": "string"
    }
  ]
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠429429

🔴500服务器错误

🔴503服务器故障

请求参数

示例代码

返回响应