# 概述
卖家销售伙伴API可以让你代表卖家检索关于他们的卖家账户的信息,比如他们参与的市场. 除了列出卖家可以销售的市场,API还提供关于市场的额外信息,比如默认语言和默认货币. API还提供卖家的具体信息,比如卖家是否在该市场暂停过房源.
# Version information
Version : v1
# Operations
getMarketplaceParticipations
<a name="paths">
# 路径
<a name="getmarketplaceparticipations">
# getMarketplaceParticipations
**GET /sellers/v1/marketplaceParticipations **
# Description
返回提交请求的卖家可以销售的市场列表,以及卖家参与这些市场的信息.
使用计划:
Rate (requests per second) | Burst |
---|---|
.016 | 15 |
更多信息,请参阅销售伙伴API文档中的 "使用计划和费率限制".
# Responses
HTTP Code | Description | Schema |
---|---|---|
200 | 市场参与者成功检索. 头: x-amzn-RateLimit-Limit (string) : 您的速率限制(每秒的请求)为这个操作. x-amzn-RequestId (string) unique request reference id. | GetMarketplaceParticipationsResponse |
错误状态代码、描述和模式,见错误响应和模式.
<a name="error-responses-and-schemas">
# 错误响应和模式
本表包含HTTP状态代码和错误响应的相关信息.
HTTP Code | Description | Schema |
---|---|---|
400 | Request有缺失或无效的参数,无法解析. Headers x-amzn-RateLimit-Limit (string):您的速率限制(每秒的请求)为这个操作. x-amzn-RequestId (string) Unique request reference id. | GetMarketplaceParticipationsResponse |
403 | 403的原因可能是拒绝访问、未经授权、过期令牌、无效签名或未找到资源. **头信息 x-amzn-RequestId (string):Unique request reference id. | GetMarketplaceParticipationsResponse |
404 | 指定的资源不存在. 头 x-amzn-RateLimit-Limit (string):您的速率限制(每秒的请求)为这个操作. x-amzn-RequestId (string) Unique request reference id. | GetMarketplaceParticipationsResponse |
413 | 请求的大小超过了最大接受的大小. 头 x-amzn-RateLimit-Limit (string):您的速率限制(每秒的请求)为这个操作._注意:_对于这个状态代码,速率限制头已被废弃,不再返回. x-amzn-RequestId (string): Unique request reference id. | GetMarketplaceParticipationsResponse |
415 | 请求的实体的格式不被请求的资源所支持. 头信息 x-amzn-RateLimit-Limit (string):你的速率限制(每秒的请求)为这个操作._注意:_对于这个状态代码,速率限制头已被废弃,不再返回. x-amzn-RequestId (string): Unique request reference id. | GetMarketplaceParticipationsResponse |
429 | 请求的频率超过了允许的范围. 头 x-amzn-RateLimit-Limit (string):你的速率限制(每秒的请求)对于这个操作._注意:_对于这个状态代码,速率限制头已被废弃,不再返回. x-amzn-RequestId (string) Unique request reference id. | GetMarketplaceParticipationsResponse |
500 | 遇到了一个意外的情况,使服务器无法完成请求. ***头信息 x-amzn-RateLimit-Limit (string):您的速率限制(每秒的请求)为这个操作._注意:_对于这个状态代码,速率限制头已被废弃,不再返回. x-amzn-RequestId (string): Unique request reference id. | GetMarketplaceParticipationsResponse |
503 | 服务器的临时超载或维护. 头 x-amzn-RateLimit-Limit (string):您的速率限制(每秒的请求)为这个操作._注意:_对于这个状态代码,速率限制头已被废弃,不再返回. x-amzn-RequestId (string): Unique request reference id. | GetMarketplaceParticipationsResponse |
<a name="definitions">
# Definitions
<a name="错误">
# Error
当请求不成功时返回的错误响应.
Name | Description | Schema |
---|---|---|
code required | 一个错误代码,用于识别发生的错误类型. | string |
message required | 一个以人类可读的形式描述错误情况的信息. | string |
details optional | 可以帮助呼叫者理解或解决这个问题的额外细节. | string |
<a name="errorlist">
# ErrorList
当一个请求不成功时返回的错误响应列表.
类型 < Error > 数组
<a name="marketplaceparticipation">
# MarketplaceParticipation
Name | Description | Schema |
---|---|---|
marketplace required | 关于亚马逊市场的详细信息,卖家可以在这里列出商品进行销售,客户可以查看和购买商品. | Marketplace |
participation required | Detailed information that is specific to a seller in a Marketplace. | Participation |
<a name="marketplaceparticipationlist">
# MarketplaceParticipationList
市场参与者名单.
类型< MarketplaceParticipation > 数组
<a name="getmarketplaceparticipationsresponse">
# GetMarketplaceParticipationsResponse
getMarketplaceParticipations操作的响应模式.
Name | Description | Schema |
---|---|---|
payload optional | The payload for the getMarketplaceParticipations operation. | MarketplaceParticipationList |
errors optional | 在getMarketplaceParticipations操作中遇到的错误. | ErrorList |
<a name="marketplace">
# Marketplace
关于亚马逊市场的详细信息,卖家可以在这里列出商品进行销售,客户可以查看和购买商品.
Name | Description | Schema |
---|---|---|
id required | The encrypted marketplace value. | string |
name required | Marketplace name. | string |
countryCode required | 市场的ISO 3166-1 alpha-2格式国家代码. Pattern : "^([A-Z]{2})$" | string |
defaultCurrencyCode required | 市场的ISO 4217格式货币代码. | string |
defaultLanguageCode required | 市场的ISO 639-1格式的语言代码. | string |
domainName required | 市场的域名. | string |
<a name="参与">
# Participation
特定于市场中的卖方的详细信息.
Name | Description | Schema |
---|---|---|
isParticipating required | - | boolean |
hasSuspendedListings required | 指定卖家是否暂停上市.如果卖家上市状态被设置为不活跃,则为真,否则为假. | boolean |