Referencia de la API de Autorización

Descripción general

La Selling Partner API para autorización ayuda a los desarrolladores a administrar las autorizaciones y verificar los permisos específicos asociados con una autorización dada.

Información de versión

Versión : v1

Información del contacto

Contacto : Soporte para desarrolladores Selling Partner API
URL de contacto : https://sellercentral.amazon.com/gp/mws/contactus.html

Información de licencia

Licencia : Licencia Apache 2.0
URL de la licencia : http://www.apache.org/licenses/LICENSE-2.0

esquema URI

Anfitrión : Sellingpartnerapi-na.amazon.com
Esquemas : HTTPS

consume

application/json

produce

application/json

Operaciones

getAuthorizationCode

Rutas

Devuelve el código de autorización Login with Amazon (LWA) para una autorización de Amazon MWS existente.

GET /authorization/v1/authorizationCode

Operación: getAuthorizationCode

Descripción

Con la operación getAuthorizationCode, puede solicitar un código de autorización de Login With Amazon (LWA) que le permitirá llamar a una Selling Partner API en nombre de un seller que ya lo autorizó a llamar a Amazon Marketplace Web Service (Amazon MWS). Especifique una developerId, un token de autenticación de MWS y una ID de seller. En conjunto, representan la autorización de Amazon MWS que el seller le otorgó anteriormente. La operación devuelve un código de autorización LWA que se puede intercambiar por un refresh token y un access token que representa la autorización para llamar a la Selling Partner API en nombre del seller. Al usar esta API, los sellers que ya lo autorizaron para Amazon MWS no necesitan volver a autorizarlo para la Selling Partner API.

Plan de uso:

Tasa (solicitudes por segundo)	Explosión
1	5

El x-amzn-RateLimit-Limit
El header de respuesta devuelve los límites de velocidad del plan de uso que se aplicaron a la operación solicitada, cuando estén disponibles. La tabla anterior indica los valores de velocidad y ráfaga predeterminados para esta operación. Los Selling partners cuyas demandas comerciales requieran mayor rendimiento pueden ver valores de velocidad y ráfaga más altos que los mostrados aquí. Para obtener más información, consulta Usage Plans and Rate Limits in the Selling Partner API.

Parámetros

Tipo	Nombre	Descripción	Esquema
Query	sellingPartnerId requerido	El ID de seller del seller para el que está solicitando la autorización de la Selling Partner API. Este debe ser el ID de seller del seller que autorizó su aplicación en Marketplace Appstore.	string
Query	developerId requerido	Tu developerId. Debe ser uno de los valores de developerId que proporcionó cuando registró su aplicación en Central de desarrolladores.	string
Query	mwsAuthToken requerido	El token de autenticación de MWS que se generó cuando el seller autorizó su aplicación en Marketplace Appstore.	string

Respuestas

Código HTTP	Descripción	Esquema
200	Éxito. headers : `x-amzn-RateLimit-Limit` (string): su límite de velocidad (solicitudes por segundo) para esta operación. `x-amzn-RequestId` (string): ID de referencia de solicitud única.	GetAuthorizationCodeResponse

Para códigos de estado de error, descripciones y esquemas, consulte Respuestas y esquemas de error .

Respuestas de error y esquemas

Esta tabla contiene códigos de estado HTTP e información asociada para respuestas de error.

Código HTTP	Descripción	Esquema
400	La solicitud tiene parámetros faltantes o no válidos y no se puede analizar. headers : `x-amzn-RateLimit-Limit` (string): su límite de velocidad (solicitudes por segundo) para esta operación. `x-amzn-RequestId` (string): ID de referencia de solicitud única.	GetAuthorizationCodeResponse
403	Indica que el acceso al recurso está prohibido. Los posibles motivos incluyen acceso denegado, no autorizado, token caducado o firma no válida. headers : `x-amzn-RequestId` (string): ID de referencia de solicitud única.	GetAuthorizationCodeResponse
404	El recurso especificado no existe. headers : `x-amzn-RateLimit-Limit` (string): su límite de velocidad (solicitudes por segundo) para esta operación. `x-amzn-RequestId` (string): ID de referencia de solicitud única.	GetAuthorizationCodeResponse
413	El tamaño de la solicitud excedió el tamaño máximo aceptado. headers : `x-amzn-RateLimit-Limit` (string): su límite de velocidad (solicitudes por segundo) para esta operación. Nota: Para este código de estado, el header de límite de tasa está obsoleto y ya no se devuelve. `x-amzn-RequestId` (string): ID de referencia de solicitud única.	GetAuthorizationCodeResponse
415	La carga útil de la solicitud está en un formato no admitido. headers : `x-amzn-RateLimit-Limit` (string): su límite de velocidad (solicitudes por segundo) para esta operación. Nota: Para este código de estado, el header de límite de tasa está obsoleto y ya no se devuelve. `x-amzn-RequestId` (string): ID de referencia de solicitud única.	GetAuthorizationCodeResponse
429	La frecuencia de las solicitudes fue mayor a la permitida. headers : `x-amzn-RateLimit-Limit` (string): su límite de velocidad (solicitudes por segundo) para esta operación. Nota: Para este código de estado, el header de límite de tasa está obsoleto y ya no se devuelve. `x-amzn-RequestId` (string): ID de referencia de solicitud única.	GetAuthorizationCodeResponse
500	Ocurrió una condición inesperada que impidió que el servidor cumpliera con la solicitud. headers : `x-amzn-RateLimit-Limit` (string): su límite de velocidad (solicitudes por segundo) para esta operación. Nota: Para este código de estado, el header de límite de tasa está obsoleto y ya no se devuelve. `x-amzn-RequestId` (string): ID de referencia de solicitud única.	GetAuthorizationCodeResponse
503	Sobrecarga temporal o mantenimiento del servidor. headers : `x-amzn-RateLimit-Limit` (string): su límite de velocidad (solicitudes por segundo) para esta operación. Nota: Para este código de estado, el header de límite de tasa está obsoleto y ya no se devuelve. `x-amzn-RequestId` (string): ID de referencia de solicitud única.	GetAuthorizationCodeResponse

Definiciones

GetAuthorizationCodeResponse

El esquema de respuesta para la operación GetAuthorizationCode.

Nombre	Descripción	Esquema
payload opcional	Un código de autorización para Login with Amazon (LWA).	AuthorizationCode
errores opcional	Una lista de respuestas de error devueltas cuando una solicitud no se realiza correctamente.	ErrorList

AuthorizationCode

Un código de autorización para Login with Amazon (LWA).

Nombre	Descripción	Esquema
authorizationCode opcional	Un código de autorización de Login With Amazon (LWA) que se puede intercambiar por un refresh token y un access token que lo autorizan a realizar llamadas a una Selling Partner API.	string

Lista de errores

Una lista de respuestas de error devueltas cuando una solicitud no se realiza correctamente.

Tipo : matriz

Error

Respuesta de error devuelta cuando la solicitud no tiene éxito.

Nombre	Descripción	Esquema
código requerido	Un código de error que identifica el tipo de error que ocurrió.	string
mensaje requerido	Un mensaje que describe la condición de error en un formato legible por humanos.	string
detalles opcional	Detalles adicionales que pueden ayudar a la persona que llama a comprender o solucionar el problema.	string