卖家API v1参考

亚马逊SPAPI

# 概述

卖家销售伙伴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