Authorization API reference
sfgoods AmazonSPAPI
# Overview
Selling Partner API for Authorization 可帮助开发人员管理授权并检查与给定授权关联的特定权限.
# Version information
Version : v1
# Operations
# Paths
# 返回现有亚马逊 MWS 授权的亚马逊登录 (LWA) 授权代码.
GET /authorization/v1/authorizationCode
1
# getAuthorizationCode
# Description
通过 getAuthorizationCode 操作，您可以请求一个亚马逊登录码（LWA）的授权，这将允许您代表已经授权您调用亚马逊商城网络服务 (Amazon MWS) 的卖家调用销售合作伙伴 API。 您指定开发者 ID、MWS 身份验证令牌和卖家 ID。 总而言之，这些代表卖家之前授予您的亚马逊 MWS 授权。 该操作返回一个 LWA 授权代码，该代码可以交换为代表卖家调用 Selling Partner API 的授权的刷新令牌和访问令牌。 通过使用此 API，已经授权您使用亚马逊 MWS 的卖家无需重新授权您使用 Selling Partner API.
Usage Plan:
| 速率(每秒恢复的请求) | 突发率 |
|---|---|
| 1 | 5 |
想了解更多信息，请参阅销售伙伴API文档中的 "使用计划和费率限制"
# Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
| Query | sellingPartnerId required | 您为其申请销售伙伴API授权的卖家的卖家ID。这必须是在Marketplace Appstore上授权你的应用程序的卖家的ID | string |
| Query | developerId required | 您的开发者 ID。这必须是您在 Developer Central 中注册应用程序时提供的开发人员 ID 值之一 | string |
| Query | mwsAuthToken required | 当卖家在 Marketplace Appstore 上授权您的应用程序时生成的 MWS Auth Token | string |
# Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | Success. Headers : x-amzn-RateLimit-Limit (string) : 您对此操作的速率限制（每秒请求数）. x-amzn-RequestId (string) : 唯一的请求参考 ID. | GetAuthorizationCodeResponse |
有关错误状态代码、描述和架构，请参阅 错误响应和架构.
# Error Responses and Schemas
此表包含 HTTP 状态代码和错误响应的相关信息.
| HTTP Code | Description | Schema |
|---|---|---|
| 400 | 请求参数缺失或无效，无法解析. Headers: x-amzn-RateLimit-Limit (string):您对此操作的速率限制（每秒请求数）. x-amzn-RequestId (string):唯一的请求参考 ID. | GetAuthorizationCodeResponse |
| 403 | 表示禁止访问资源。 可能的原因包括拒绝访问、未授权、过期令牌或无效签名. Headers: x-amzn-RequestId (string):唯一的请求参考 ID. | GetAuthorizationCodeResponse |
| 404 | 请求的资源不存在. Headers: x-amzn-RateLimit-Limit (string):您对此操作的速率限制（每秒请求数）. x-amzn-RequestId (string):唯一的请求参考 ID. | GetAuthorizationCodeResponse |
| 413 | 请求大小超过了可接受的最大大小. Headers: x-amzn-RateLimit-Limit (string):您对此操作的速率限制（每秒请求数）.Note: 对于此状态码，速率限制标头已弃用且不再返回. x-amzn-RequestId (string):唯一的请求参考 ID. | GetAuthorizationCodeResponse |
| 415 | 请求的格式不受支持. Headers: x-amzn-RateLimit-Limit (string):您对此操作的速率限制（每秒请求数）.Note: 对于此状态码，速率限制标头已弃用且不再返回. x-amzn-RequestId (string):唯一的请求参考 ID. | GetAuthorizationCodeResponse |
| 429 | 请求的频率大于允许的频率. Headers: x-amzn-RateLimit-Limit (string):您对此操作的速率限制（每秒请求数）.Note: 对于此状态码，速率限制标头已弃用且不再返回. x-amzn-RequestId (string):唯一的请求参考 ID. | GetAuthorizationCodeResponse |
| 500 | 发生了一个意外的情况，使服务器无法满足请求. Headers: x-amzn-RateLimit-Limit (string):您对此操作的速率限制（每秒请求数）.Note: 对于此状态码，速率限制标头已弃用且不再返回. x-amzn-RequestId (string):唯一的请求参考 ID. | GetAuthorizationCodeResponse |
| 503 | 服务器暂时超载或维护. Headers: x-amzn-RateLimit-Limit (string):您对此操作的速率限制（每秒请求数）.Note: 对于此状态码，速率限制标头已弃用且不再返回. x-amzn-RequestId (string):唯一的请求参考 ID. | GetAuthorizationCodeResponse |
# Definitions
# GetAuthorizationCodeResponse
GetAuthorizationCode 操作的响应架构。
| Name | Description | Schema |
|---|---|---|
| payload optional | 一个登录亚马逊（LWA）的授权码. | AuthorizationCode |
| errors optional | 请求不成功时返回的错误响应列表. | ErrorList |
# AuthorizationCode
一个登录亚马逊（LWA）的授权码.
| Name | Description | Schema |
|---|---|---|
| authorizationCode optional | 一个 Login with Amazon (LWA) 授权代码，可用于交换授权您调用销售伙伴 API 的刷新令牌和访问令牌. | string |
# ErrorList
请求不成功时返回的错误响应列表.
Type : < Error > array
# Error
当请求不成功时返回的错误响应.
| Name | Description | Schema |
|---|---|---|
| code required | 标识发生的错误类型的错误代码. | string |
| message required | 以可读的形式描述错误情况的消息. | string |
| details optional | 可帮助调用者理解或解决问题的其他详细信息. | string |