使用 Postman 创建销售伙伴 API 模型
使用 Postman 创建销售伙伴 API 模型
本文档介绍如何为销售伙伴 API (SP-API) 模型设置和使用 {{0}}。您可以使用 {{1}} 生成使用亚马逊账户登录 (LWA) 访问令牌、调用 SP-API 端点以及调用 SP-API 沙箱端点。
进行调用所需的凭证
- LWA
client_id
和client_secret
。注册应用程序后,您将获得这些凭证。请参阅查看您的应用程序信息和凭证,了解详细信息。 - LWA 刷新代币。之后您将获得 LWA 刷新令牌 授权您的应用程序。
- SP-API 端点。有关更多信息,请参阅 SP-API 端点。
使用 Postman 生成 “用亚马逊账户登录” (LWA) 访问令牌
使用亚马逊账户登录 (LWA) 允许亚马逊买家使用其亚马逊用户名和密码登录已注册的第三方网站或移动应用程序(“客户端”)。客户端可能会要求买家共享其亚马逊个人资料中的一些个人信息,包括姓名、电子邮件地址和邮政编码。在 SP-API 模型中使用 {{0}} 之前,您必须先生成访问令牌才能向 SP-API 进行身份验证。
-
打开 邮差 并登录您的账户。
-
对于 Workspaces,选择您的工作空间。
-
选择 New。
-
在 Create New 对话框,选择 HTTP Request。
-
对于 Request,选择 POST。
-
将以下链接复制并粘贴到文本框中。
https://api.amazon.com/auth/o2/token -
选择 Authorization 选项卡和 for Type,选择 No Auth。
-
选择 Body 选项卡,然后选择 x-www-form-urlencoded。
-
在 Body 表,添加以下键值对:
键 Value grant_type
refresh_token refresh_token
[您的刷新令牌值] client_id
[您的客户端 ID 值] client_secret
[您的客户端密钥值] -
选择 Send。
响应返回您用于向 SP-API 进行身份验证的访问令牌。
"access_token": "Atza|*****",
"refresh_token": "Atzr|*****"'
"token_type": "bearer",
"expires_in": 3600
将 SP-API 模型导入 Postman
在调用 SP-API 端点之前,必须将 SP-API 模型导入 {{0}}。
-
打开 GitHub 上的 selling-partner-api-models 文件夹。
-
在文件夹列表中,找到并选择要下载的 API 模型,然后选择 JSON 文件。
-
在 JSON 文件视图上,选择 Raw 查看源代码或选择下载图标以下载原始文件。
-
复制模型源代码。
-
打开文本编辑器(如记事本)并粘贴模型文本。然后,以“.json”扩展名保存文件。
-
登录 Postman。
-
对于 Workspaces,选择您的工作空间。
-
选择 Import,选择你的 JSON 文件,然后选择 Open。
-
在 Import 对话框,选择 Postman Collection 然后选择 Import。
成功导入后,将显示一条成功消息。
调用 SP-API 端点
-
登录 Postman。
-
对于 Workspaces,选择您的工作空间。
-
在 Collections 选项卡,选择新导入的 API 并选择
GET
操作。 -
如果还没有 LWA 访问令牌,请使用 Postman 生成 LWA 访问令牌。您需要 LWA 访问令牌才能生成刷新令牌。
-
在 Headers 选项卡,添加以下密钥对:
键 Value x-amz-access-token
[您的访问令牌值] -
选择 Send。
响应文本填充在 Response 窗口。
调用 SP-API 沙箱端点
调用销售伙伴 API 沙箱的过程与进行生产调用的过程相同,不同之处在于您要将调用指向销售伙伴 API 沙箱端点。销售伙伴 API 提供了两个沙箱环境,可供您在不影响生产数据、不触发真实事件的前提下测试应用程序。
销售伙伴 API 静态沙箱使用模式匹配来返回静态的模拟响应。销售伙伴 API 动态沙箱将请求路由到沙箱后端,后端可以根据请求参数返回真实的响应。
请参阅销售伙伴 API 沙箱,了解详细信息。
-
登录 Postman。
-
将您正在使用的 API 的 Swagger 模型导入到您的 https://github.com/amzn/selling-partner-api-models/blob/main/models/orders-api-model/ordersV0.json 工作区。例如,订单 API Swagger 模型。
-
对于 Workspaces,选择您的工作空间。
-
在 Collections 选项卡,选择您的收藏并选择
GET
操作。例如,如果您想测试 GET Orders API 调用,请选择 get Orders API 调用。 -
将
{{baseUrl}}
设置为销售伙伴 API 沙箱。 -
在 Params 选项卡上,传递来自 Swagger 模型的静态请求值。例如,订单 API。
-
调用沙箱端点时,您需要检查您的请求是否包含相应 Swagger 模型中定义的所有必需参数。请参考以下订单 API v0 Swagger 模型示例,其中 Get Order API 调用突出显示为成功响应:
-
如果还没有 LWA 访问令牌,请使用 Postman 生成 LWA 访问令牌。您需要 LWA 访问令牌才能交换刷新令牌。
-
在 Headers 选项卡,添加以下密钥对:
键 Value x-amz-access-token
[您的访问令牌值] -
选择 Send。
-
验证响应返回的有效负荷是否与 Swagger 模型相匹配。
响应文本填充在 Response 窗口。
Updated 23 days ago