# 亚马逊MWS到销售伙伴API迁移指南
# 内容
- 概览
- 什么是销售伙伴API？
- Selling Partner API features
- [将API从亚马逊MWS映射到销售伙伴API](#mapping-apis-from-amazon-mws to the-selling-partner-api)
- 迁移工作流程概述
- 教程。将亚马逊MWS应用程序转换成销售伙伴API应用程序
- 销售伙伴API中的角色
- 限制性数据令牌要求
- 销售伙伴API沙盒
- 额外资源
# 概述
本文解释了什么是销售伙伴API，它与亚马逊市场网络服务（Amazon MWS）有什么不同，并告诉您如何将您的亚马逊MWS应用转换为混合型销售伙伴API应用。
# 什么是Selling Partner API？
销售伙伴API是一个基于REST的API，它帮助亚马逊销售伙伴以编程方式访问他们的列表、订单、付款、报告等数据。使用销售伙伴API的应用程序可以提高销售效率，减少劳动力需求，并改善对客户的响应时间，帮助销售伙伴发展他们的业务。销售伙伴API是Amazon MWS的现代化，包括以前Amazon MWS提供的所有功能。所有未来的开发将只适用于销售伙伴API。
# 销售伙伴API的功能
每个销售伙伴API都有一个Swagger模型，一个API参考，在某些情况下还有一个用例指南。还包括客户端库，以帮助验证对销售伙伴API的调用。
销售伙伴API的一些新功能包括。
- 基于REST的API，具有JSON格式的输入和输出。
- 所有地区都支持的新端点。
- 自动生成SDK的逐步说明（见Selling Partner API Developer Guide (opens new window)）。
- 一个带有独立沙盒端点的沙盒功能，用于用模拟数据进行测试。
- 一个动态使用计划，根据各种措施自动调整每个销售伙伴的费率限制。
- 支持所有地区的销售伙伴API应用。
- 支持受限数据令牌（RDTs），这有助于保护客户的个人身份信息（PII）。
新的和更新的销售伙伴API。
A+内容API. 使销售伙伴能够创建和编辑A+内容。
**授权API. ** 将现有的MWS授权令牌与销售伙伴API授权代码进行交换。
目录项目API. 提供有关亚马逊目录的详细信息。
**FBA入站资格API. ** 检查ASIN参与亚马逊履行（FBA）的资格，以避免为不合格的ASIN创建入站发货。
FBA Inventory API. 新的和改进的FBA库存API，为FBA卖家提供新的功能。
**FBA Small and Light API. ** 支持FBA Small and Light计划。
Messaging API. 使销售伙伴能够向客户发送支持的信息类型。
**Notifications API. ** 包括品牌商品内容变化、产品类型名称变化、MFN订单状态变化和B2B报价变化的新通知。
Pricing API. 获取产品定价和报价信息。
产品费用API. 获取产品的估计费用。
销售API. 生成销售历史报告。
**服务API. ** 使服务提供者能够获得和修改他们的服务订单。
Shipping API. 提供对亚马逊运输服务的程序化访问。
Solicitations API. 使销售伙伴能够向客户发送非关键性的招揽信息。
Tokens API. 为访问客户的个人身份信息（PII）提供了一种安全方式。
# 从亚马逊MWS到销售伙伴API的映射API
# 迁移工作流程概述
迁移工作流程将亚马逊MWS应用程序转换为混合销售伙伴API应用程序。混合应用程序可以同时对Amazon MWS和SP-API进行API调用。有了混合应用程序，您就拥有了来自两种服务的功能，并且在迁移过程中，应用程序的停机时间为零。
下图提供了迁移工作流程的概述。
# 教程。将亚马逊MWS应用程序转换为销售伙伴API应用程序
本教程告诉您如何将亚马逊MWS应用程序转换为混合型销售伙伴API应用程序。
先决条件
- 一个在Marketplace Appstore中发布的已注册的亚马逊MWS应用程序。
- 一个亚马逊网络服务（AWS）账户。要创建一个帐户，注册AWS (opens new window)。
步骤
第3步。将您的亚马逊MWS应用程序转换成混合型销售伙伴API应用程序
第6步。在Marketplace Appstore发布你的混合销售伙伴应用程序
[步骤7. 将亚马逊MWS授权迁移到销售伙伴API授权](#Step-7-Migrate-Amazon-MWS-authorizations to-Selling-Partner-API-authorizations)
# 步骤1. 请求您的销售伙伴API应用程序所需的数据访问
- 使用与您的亚马逊MWS开发者账户相关的凭证登录Seller Central。
- 在合作伙伴网络菜单上，点击开发应用程序。
- 在开发者中心页面上，点击你的开发者资料。
- 在开发者简介页面，在数据访问部分，选择你的应用程序需要的角色并提交表格。关于选择或申请角色的更多信息，请参见销售伙伴API中的角色 (opens new window)。
- 点击注册。
开发者支持团队将评估您的请求，并在他们审查完成后回复您的支持案例。这个过程可能需要几天的时间，这取决于你的资料回复。
注意：在审查过程中，你不能改变你的开发人员配置文件。然而，您可以通过访问开发者中心并查看您的开发者注册正在审查横幅上的说明来监控您的注册状态。
# 第2步。创建和配置IAM资源
一些AWS身份和访问管理(IAM) (opens new window)资源是您将Amazon MWS应用程序转换为销售伙伴API应用程序所必需的，包括IAM用户、IAM策略和IAM角色 (opens new window)。当您创建您的IAM角色时，您还会生成一个亚马逊资源名称（ARN），这是您的IAM角色的唯一标识。当您创建和配置您的IAM资源时，请确保注意IAM角色ARN--当您在步骤3中将您的Amazon MWS应用程序转换为混合销售伙伴API应用程序时，您需要这个IAM角色ARN。
你可以通过两种方式创建和配置你的IAM资源。
- 要以编程方式创建和配置IAM资源，请参阅Selling Partner API on AWS Quick Start (opens new window)。AWS上的销售伙伴API快速入门包括一个AWS CloudFormation模板，您可以在您的AWS账户中部署该模板，以编程方式创建所有必要的IAM策略和角色。
*要手动创建和配置IAM资源，请参阅《销售伙伴API开发者指南》中的创建和配置IAM策略和实体 (opens new window)。
# 步骤3. 将您的亚马逊MWS应用程序转换为混合型Selling Partner API应用程序
- 使用您注册为开发人员时使用的凭证登录Seller Central (opens new window)。
- 在合作伙伴网络菜单中，点击开发应用程序。
- 在开发者中心页面上，在您的亚马逊MWS应用程序旁边，点击编辑应用程序。
- 在应用程序注册表格中，对于API类型，选择SP-API和MWS。这一选择将在表格中填入您的应用细节。
- 在IAM ARN框中，粘贴您在步骤2.创建和配置IAM角色创建的IAM角色的ARN。如果你不确定这个值，你可以根据你创建IAM角色的方式找到ARN。
- 如果您使用Selling Partner API on AWS Quick Start Deployment Guide以编程方式创建您的IAM资源，请粘贴您在Post-deployment steps - Copy the IAM role ARN (opens new window)中复制的ARN。
- 如果您使用《销售伙伴API开发者指南》中的步骤手动创建了IAM资源，请粘贴您在步骤4.创建IAM角色 (opens new window)中复制的IAM角色的ARN。这个IAM角色也应该附加AWS安全令牌服务（AWS STS）策略。
- 要在AWS管理控制台中查看ARN，请登录IAM仪表板 (opens new window)，在左侧导航窗格中选择角色。搜索并选择你创建的SP-API角色。在摘要页面，复制角色ARN。
- 在角色部分，选择你的应用程序所需的所有角色。关于选择或申请角色的更多信息，请参见销售伙伴API中的角色 (opens new window)。
- 点击保存并退出，完成注册。
在你提交注册后，你将有一个混合的销售伙伴API应用程序，处于草稿状态。你现在已经准备好设置和测试一个授权工作流程了。
# 步骤4. 实施授权工作流
为你的混合销售伙伴API应用程序设置并测试一个授权工作流程。欲了解更多信息，请参阅《销售伙伴API开发者指南》中的授权销售伙伴API应用程序 (opens new window)。当你完成测试你的授权工作流时，一定要把你的测试授权工作流转换成生产授权工作流。
# 步骤5. 连接到Selling Partner API
设置一个工作流来调用销售伙伴API中的操作。这个工作流程包括交换Login with Amazon (LWA)令牌，构建URI，添加头信息，以及创建和签署请求。为了设置这个工作流程，你可以生成和使用一个包括LWA令牌交换和认证的SDK。欲了解更多信息，请参阅《销售伙伴API开发者指南》中的生成带有LWA令牌交换和认证的Java SDK (opens new window)和使用生成的Java SDK连接到销售伙伴API (opens new window)。
关于连接到Selling Partner API沙盒的信息，请参阅《Selling Partner API开发者指南》中的Selling Partner API沙盒 (opens new window)。
# 步骤6. 在Marketplace Appstore中发布你的混合销售伙伴应用程序
- 使用你用来注册为开发者的凭证，登录Seller Central (opens new window)。
- 在合作伙伴网络菜单上，点击开发应用程序。
- 在开发者中心页面上，找到你的应用程序。点击编辑应用程序下拉，然后点击编辑列表。
- 在应用程序注册表格中，对于API类型，选择SP-API和MWS。该选择将在表格中填入您的应用程序详细信息。
- 完成剩余的字段并提交表格。
在完成最后一个屏幕后，你的混合销售伙伴应用程序将被发布到Marketplace Appstore。这个过程可能需要5到10个工作日。
# 第7步。将亚马逊MWS的授权迁移到销售伙伴API的授权上
**注意：**在将现有的Amazon MWS授权迁移到Selling Partner API授权之前，确认您的Selling Partner API应用程序已在Marketplace Appstore中发布。
将您现有的Amazon MWS授权迁移到Selling Partner API授权。欲了解更多信息，请参阅[Authorization API Use Case Guide]（https://github.com/amzn/selling-partner-api-docs/blob/main/guides/en-US/use-case-guides/authorization-api-use-case-guide/authorization-api-use-case-guide-v1.md）。
# 步骤8. 将您的亚马逊MWS调用迁移到Selling Partner API调用
最后一步是更新您的应用程序，使以前触发调用Amazon MWS操作的动作现在触发调用相应的Selling Partner API操作。请参阅Mapping APIs from Amazon MWS to the Selling Partner API以查看哪些Selling Partner API操作对应于您的应用程序一直在调用的Amazon MWS操作。
# Selling Partner API 中的角色
角色是 Selling Partner API 用来确定开发人员或应用程序是否可以访问某个操作或资源的机制。作为一个开发者，你必须申请并符合一个特定的角色，否则你将无法访问该角色下的操作和资源。
Selling Partner API中的角色比Amazon MWS中的角色更加细化。Amazon MWS有三个角色，而Selling Partner API有11个。请参阅 Roles in the Selling Partner API (opens new window) 以了解对 Selling Partner API 中角色的详细解释，以及角色及其定义的列表。
#受限数据令牌（RDT）要求
销售伙伴API通过要求调用受限数据令牌（RDT）来保护客户的个人身份信息（PII）（返回受限数据的操作）。关于获取和使用RDT来调用受限操作的信息，请参见Tokens API用例指南 (opens new window)
# Selling Partner API沙盒
Selling Partner API提供了一个沙盒环境，允许你测试你的应用程序，而不影响生产数据或触发真实世界的事件。欲了解更多信息，请参阅《销售伙伴API开发者指南》中的Selling Partner API Sandbox (opens new window)。