Como autorizar aplicativos da API do parceiro de vendas
Autorizar aplicativos da SP-API
The authorization model for the Selling Partner API is based on Login with Amazon, Amazon's implementation of OAuth 2.0. In this model your application is authorized through interactions with pages displayed by Amazon and by your website. The web browser is the user-agent that passes parameters between your website and Amazon at each selling partner action. To implement OAuth authorization you must configure your website to (1) accept and process the parameters that Amazon passes to it, and (2) redirect the web browser and pass parameters to Amazon.
Como meu aplicativo é autorizado?
-
Aplicativos públicos para vendedores: aplicativos que estão disponíveis publicamente e são autorizados por vendedores. Esses aplicativos podem ser autorizados usando os seguintes métodos:
- Selling Partner Appstore authorization workflow An OAuth authorization workflow initiated from the Selling Partner Appstore detail page.
- Website authorization workflow An OAuth authorization workflow initiated from your own website.
-
Aplicativos públicos para fornecedores: aplicativos que estão disponíveis publicamente e são autorizados por fornecedores. Esses aplicativos podem ser autorizados usando o seguinte método:
- Website authorization workflow An OAuth authorization workflow initiated from your own website.
-
Aplicativos privados para vendedores ou fornecedores: aplicativos que estão disponíveis somente para sua organização. Podem ser aplicativos do vendedor ou do fornecedor. Esses aplicativos podem ser autorizados usando o seguinte método:
Observação
You can call Grantless operations without explicit authorization from a selling partner.
For more information, refer to Terminology.
Criar um URI de autorização do OAuth
Um URI de autorização do OAuth é um componente essencial para criar e testar fluxos de trabalho de autorização da API do parceiro de vendas. O URI de autorização do OAuth redireciona o navegador para uma página de consentimento da Amazon, na qual você ou um parceiro de vendas podem autorizar seu aplicativo a fazer chamadas para a API do parceiro de vendas.
If a selling partner authorizes your application starting from your own website using the Website authorization workflow, then your website uses an OAuth authorization URI to redirect the selling partner to the Amazon consent page. Even if a selling partner authorizes your application starting from the Selling Partner Appstore, the Selling Partner appstore authorization workflow, you still need an OAuth authorization URI to test your authorization workflow in draft status before creating a live listing in the Selling Partner Appstore.
Ao criar um URI de autorização do OAuth, os aplicativos são agrupados em dois tipos:
-
Todos os aplicativos públicos e privados para vendedores: podem ser: (1) aplicativos que estão disponíveis publicamente e são autorizados por um vendedor ou por um fornecedor e (2) aplicativos para vendedores que estão disponíveis somente para sua organização e são autoautorizados.
-
Aplicativos privados para fornecedores: aplicativos para fornecedores que estão disponíveis somente para sua organização e são autoautorizados.
Os procedimentos a seguir explicam como criar um URI de autorização do OAuth, dependendo do tipo de aplicativo.
Observação
Você encontra o ID do aplicativo após o nome do aplicativo no console do desenvolvedor.
Criar um URI de autorização do OAuth para aplicativos públicos de vendedores
-
Get the Seller Central URL for the marketplace where you want selling partners to authorize your application. Refer to Seller Central URLs for a list of URLs by marketplace. Example:
https://sellercentral.amazon.com
-
Combine o URL do Seller Central com
/apps/authorize/consent?application_id={your application ID}
.Exemplo:
https://sellercentral.amazon.com/apps/authorize/consent?application_id=amzn1.sellerapps.app.0bf296b5-36a6-4942-a13e-EXAMPLEfcd28
Criar um URI de autorização do OAuth para aplicativos públicos de fornecedores
-
Get the Vendor Central URL for the marketplace where you want selling partners to authorize your application. Refer to Vendor Central URLs for a list of URLs by marketplace. Example:
https://vendorcentral.amazon.com
-
Combine o URL do Vendor Central com
/apps/authorize/consent?{your application ID}
.Exemplo:
https://vendorcentral.amazon.com/apps/authorize/consent?application_id=amzn1.sellerapps.app.0bf296b5-36a6-4942-a13e-EXAMPLEfcd28
You must construct OAuth authorization URIs for the marketplaces in which selling partners will authorize your application. For example, if a seller has a Seller Central account for Mexico, they will need an OAuth authorization URI for Mexico (example: https://sellercentral.amazon.com.mx/apps/authorize/consent?application_id=amzn1.sellerapps.app.0bf296b5-36a6-4942-a13e-EXAMPLEfcd28
) to initiate authorization of your application. Authorizations are regional. When the authorization is complete, your application will have access to the seller's account in any marketplace in the North America region. The same concepts apply to vendors using Vendor Central. You can use the GetMarketplaceParticipations API to discover the active marketplaces for a selling partner.
Se você estiver criando um URI de autorização do OAuth para testar seu fluxo de trabalho de autorização, adicione o parâmetro version=beta. Isso indica que o fluxo de trabalho de autorização é para um aplicativo em status de rascunho. Exemplo: https://sellercentral-europe.amazon.com/apps/authorize/consent?application_id=amzn1.sellerapps.app.0bf296b5-36a6-4942-a13e-EXAMPLEfcd28&version=beta
For information about creating and testing an authorization workflow, refer to Selling Partner Appstore authorization workflow and Website authorization workflow.
Updated 7 months ago