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:

  • 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:

  • 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

  1. 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

  2. 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

  1. 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

  2. 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.


Esta página ajudou você?