授权API v1用例指南
# 什么是授权API?
通过授权API,您可以将卖家之前授予您的亚马逊市场网络服务(Amazon MWS)的授权迁移到混合销售伙伴API(SP-API)应用中.,这样就不需要为您的混合SP-API应用向该卖家请求授权.
**注意.**混合SP-API应用程序的授权在一年后过期.请确保让你的销售伙伴在他们的授权过期前每年重新授权你的SP-API混合应用程序.
你什么时候需要使用授权API?假设您在亚马逊卖家中心合作伙伴网络上发布了一个亚马逊MWS应用程序. 一些卖家已经授权您为亚马逊MWS开发者,以便他们可以使用您的应用程序. 您后来将您的亚马逊MWS应用程序转换为一个混合SP-API应用程序 现在你想让你的应用程序代表这些卖家调用SP-API.授权API让你做到这一点,而你的销售伙伴不需要授权你的混合SP-API应用程序.
# Tutorial: 将亚马逊MWS授权迁移到销售伙伴API应用程序中
本教程告诉您如何使用授权API来获得授权,以代表先前授权您为亚马逊MWS开发者的卖家调用销售伙伴API操作.
先决条件
本教程假设您在亚马逊卖家中心合作伙伴网络(Amazon SCPN).上发布了一个混合型销售伙伴API应用程序,此外,它还假设您按照以下步骤发布了您的应用程序
1.您在亚马逊SCPN上发布了一个亚马逊MWS应用程序. 2.一个或多个卖家已经授权你的开发者ID代表你对亚马逊MWS进行调用. 3. 您将您的亚马逊MWS应用转换为混合销售伙伴API应用草案. 4. 您将您的混合销售伙伴API应用程序发布到亚马逊SCPN.
更多信息,请参见《亚马逊销售伙伴API开发者指南》中的混合销售伙伴API应用 (opens new window).
步骤
# 步骤1.获得一个LWA授权码
LWA授权代码代表着代表授权你作为亚马逊MWS开发者的卖家对销售伙伴API进行调用的授权.
注意: LWA授权代码在5分钟后过期.确保在它过期前换成LWA刷新令牌
获得LWA授权代码
1.获得之前授权你为亚马逊MWS开发者的卖家ID.
2.获得卖家授权你时给你的MWS授权令牌.
3.调用授权API的getAuthorizationCode (opens new window)操作,传递以下参数
名称 | 描述 | 需要 |
---|---|---|
sellingPartnerId | 您为其申请销售伙伴API授权的卖家ID. 这必须是在亚马逊销售中心合作伙伴网络上授权您的应用程序的卖家ID(Amazon SCPN). 类型:字符串 | 是 |
developerId | 你的开发者ID. 这必须是你在开发者中心注册混合应用时提供的开发者ID值之一. 这也必须是卖家授权你代表他们调用亚马逊MWS的开发者ID. 类型: string | Yes |
mwsAuthToken | 卖家在亚马逊SCPN上授权你的应用程序时产生的MWS Auth Token. 类型: string | Yes |
请求示例
GET https://sellingpartnerapi-na.amazon.com/authorization/v1/authorizationCode
**重要的是:**你指定的开发者ID必须是你在亚马逊SCPN.注册你的应用上市时提供的同一个开发者ID,否则服务会返回错误.
该操作返回一个LWA授权代码.
响应
一个成功的响应包括以下内容
名称 | 描述 | 需要 |
---|---|---|
getAuthorizationCodeResponse | GetAuthorizationCode操作的响应模式. 类型GetAuthorizationCodeResponse (opens new window) | Yes |
响应示例
{
"payload": {
"authorizationCode": "authcodeexample"
}
}
**注意:**虽然getAuthorizationCode操作可以获得代表卖家调用Selling Partner API的授权,但调用该操作本身并不需要任何卖家的授权.在这方面,getAuthorizationCode操作是一个 "无授权 "操作,与其他Selling Partner API操作有不同的授权模式.关于调用getAuthorizationCode操作的信息,请参阅《亚马逊Selling Partner API开发者指南》中的无授权操作 (opens new window)
# 步骤2.将LWA授权码换成LWA刷新令牌
调用LWA授权服务器,将LWA授权代码换成LWA刷新令牌.收到刷新令牌后,您的应用程序就被授权代表卖家调用Selling Partner API操作.
欲了解更多信息,请参阅《销售伙伴API开发者指南》中的授权销售伙伴API应用程序 (opens new window).