Authorization API reference

AmazonSPAPI

# Overview

Selling Partner API for Authorization 可帮助开发人员管理授权并检查与给定授权关联的特定权限.

# Version information

Version : v1

# Operations

getAuthorizationCode

# 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
Last Updated: 2022/10/11 下午11:15:53