销售伙伴 API 是一个基于 REST 的 API,亚马逊卖家可以使用这些接口,以编程方式访问他们有关商品、订单、付款、报告等的数据。使用销售伙伴 API 的应用程序可以提高销售效率,减少人力需求并缩短响应客户的时间,从而帮助卖家发展业务。销售伙伴 API 基于亚马逊商城网络服务(亚马逊 MWS)的功能构建,但提供了一些功能,帮助开发者及其卖家合作伙伴提高可用性和安全性。
使用销售伙伴 API,您可以:
-
设置卖家从商城应用商店详情页面或从您自己的网站启动的 OAuth 授权工作流程。
-
生成可以帮助您进行 LWA 令牌交换和身份验证的 SDK。
-
创建混合应用程序,可同时调用销售伙伴 API 和亚马逊 MWS。
-
通过调用沙箱环境来测试应用程序。
销售伙伴 API HTTP 方法
销售伙伴 API 支持这些 HTTP 方法。
HTTP 方法 | 描述 |
---|---|
GET | 检索资源数据或资源列表。 |
POST | 将实体提交到指定的资源,通常会引发状态更改或给服务器带来连带影响。 |
PUT | 将目标资源的所有当前表示形式替换为请求负载。 |
销售伙伴 API 端点
销售伙伴 API 端点与特定 AWS 区域相关联。AWS 区域非常重要,因为它是凭证范围的一部分,是在调用销售伙伴 API 时计算签名所必需的。有关更多信息,请参阅凭据范围。
销售区域 | 端点 | AWS 区域 |
---|---|---|
北美(加拿大、美国、墨西哥和巴西商城) | https://sellingpartnerapi-na.amazon.com | us-east-1 |
欧洲(西班牙、英国、法国、荷兰、德国、意大利、土耳其、阿联酋和印度商城) | https://sellingpartnerapi-eu.amazon.com | eu-west-1 |
远东(新加坡、澳大利亚和日本商城) | https://sellingpartnerapi-fe.amazon.com | us-west-2 |
marketplaceId 值
marketplaceId
标识了请求的商城。
北美
国家/地区 | marketplaceId | 国家/地区代码 |
---|---|---|
加拿大 | A2EUQ1WTGCTBG2 | CA |
美国 | ATVPDKIKX0DER | US |
墨西哥 | A1AM78C64UM0Y8 | MX |
巴西 | A2Q3Y263D00KWC | BR |
欧洲
国家/地区 | marketplaceId | 国家/地区代码 |
---|---|---|
西班牙 | A1RKKUPIHCS9HS | ES |
英国 | A1F83G8C2ARO7P | GB |
法国 | A13V1IB3VIYZZH | FR |
荷兰 | A1805IZSGTT6HS | NL |
德国 | A1PA6795UKMFR9 | DE |
意大利 | APJ6JRA9NG5V4 | IT |
土耳其 | A33AVAJ2PDY3EV | TR |
阿拉伯联合酋长国 | A2VIGQ35RCS4UG | AE |
印度 | A21TJRUUN4KGV | IN |
远东
国家/地区 | marketplaceId | 国家/地区代码 |
---|---|---|
新加坡 | A19VAU5U5O7RUS | SG |
澳大利亚 | A39IBJ37TRP1C6 | AU |
日本 | A1VC38T7YXB528 | JP |
全球应用程序
您只需在您选择的区域和商城以开发者的身份注册一次,即可创建一个销售伙伴 API 应用程序,该应用程序可由任何区域或商城的卖家授权。只要端点与授权您的应用程序的卖家来自同一区域,您只需一组开发者凭证(您的 AWS 访问密钥编码和 AWS 访问密钥)即可调用任何销售伙伴 API 端点。重要说明。 如果您有混合销售伙伴 API 应用程序,则您对亚马逊商城网络服务(亚马逊 MWS)端点的调用与亚马逊 MWS 应用程序具有相同的限制。也就是说,当您调用亚马逊 MWS 端点时,您必须使用与该端点来自的区域关联的亚马逊 MWS 访问密钥。
注册为开发者
您需要注册为销售伙伴 API 开发者,然后才能注册您的销售伙伴 API 应用程序。
注册为开发者
-
使用您想要与您的开发者账户关联的凭据登录卖家平台。
-
在应用程序和服务菜单中,单击开发应用程序。
此时将显示开发者平台页面。
-
按照说明注册成为开发者。