As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Integrando a API do Amazon Selling Partner
Para acessar os dados por meio da API do Amazon Selling Partner (SP-API), você deve concluir as seguintes ações:
1. [Registre-se como desenvolvedor do SP-API](#integrating-developer)
1. [Solicitar funções da SP-API](#integrating-roles)
1. [Registre sua inscrição](#integrating-register)
1. [Selecione um modelo de autorização para seu aplicativo](#integrating-authorization)
1. [Conecte-se ao SP-API](#integrating-connect)
## Registre-se como desenvolvedor do SP-API
Antes de registrar seu aplicativo SP-API, você deve criar uma conta de desenvolvedor da Amazon e se registrar como desenvolvedor SP-API. Para obter uma visão geral abrangente do processo de registro de desenvolvedores, consulte Visão geral do [registro da SP-API na documentação](https://developer-docs.amazon.com/sp-api/docs/sp-api-registration-overview) da SP-API.
## Solicitar funções da SP-API
Uma [função de SP-API](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api) determina se um desenvolvedor ou aplicativo tem acesso a uma operação ou recurso específico. Como desenvolvedor, você deve solicitar e se qualificar para uma função específica, ou não poderá acessar as operações e os recursos agrupados sob essa função.
As funções protegem o acesso a informações de identificação pessoal (PII) e outros dados confidenciais. Eles limitam o acesso aos dados para garantir que os desenvolvedores possam acessar somente os dados necessários para o aplicativo. Isso ajuda a proteger os dados do cliente e a preservar a confiança do cliente.
O acesso aos dados disponíveis nos relatórios de análise de marca exige que você tenha a [função Brand Analytics](https://developer-docs.amazon.com/sp-api/docs/brand-analytics-role). Para obter mais informações sobre como solicitar acesso a uma função, consulte [Como faço para solicitar e me qualificar para uma função](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#how-do-i-request-and-qualify-for-a-role) na documentação da SP-API.
## Registre sua inscrição
O processo de registro varia um pouco dependendo do tipo de inscrição. Para fins de registro, os aplicativos são classificados como um dos seguintes tipos:
+ **Aplicativos públicos e aplicativos de vendedores privados** — Esses são aplicativos que estão disponíveis publicamente e são autorizados por um vendedor ou fornecedor, ou são aplicativos de vendedores que estão disponíveis somente para sua organização e são autoautorizados.
+ Aplicativos de **fornecedores privados — Esses são aplicativos** de fornecedores que estão disponíveis somente para sua organização e são autoautorizados.
Para obter mais informações, consulte [Registrar seu aplicativo](https://developer-docs.amazon.com/sp-api/docs/registering-your-application) na documentação do SP-API.
## Selecione um modelo de autorização para seu aplicativo
O modelo de autorização da Selling Partner API é baseado no [Login with Amazon](https://developer.amazon.com/docs/login-with-amazon/documentation-overview.html), uma implementação OAuth 2.0 da Amazon. Sua inscrição é autorizada por meio de interações com páginas exibidas pela Amazon e seu site. O navegador da web é o agente do usuário que passa os parâmetros entre seu site e a Amazon em cada ação do parceiro de vendas. Para implementar a OAuth autorização, você deve configurar seu site para aceitar e processar os parâmetros que a Amazon passa para ele. Você também deve configurar seu site para redirecionar o navegador e passar parâmetros para a Amazon. Para obter mais informações sobre autorização, consulte [Autorização de aplicativos da API do parceiro de vendas](https://developer-docs.amazon.com/sp-api/docs/authorizing-selling-partner-api-applications) na documentação da SP-API.
### Entenda a autorização do aplicativo
Para fins de autorização, existem três tipos de aplicativos:
+ **Aplicativos públicos para vendedores** — Esses aplicativos estão disponíveis publicamente e são autorizados pelos vendedores. Você pode escolher um dos seguintes fluxos de trabalho de autorização:
+ [Fluxo de trabalho de autorização da Selling Partner Appstore](https://developer-docs.amazon.com/sp-api/docs/selling-partner-appstore-authorization-workflow) — Um fluxo de trabalho de OAuth autorização que é iniciado na página de detalhes da Selling Partner Appstore.
+ [Fluxo de trabalho de autorização do site](https://developer-docs.amazon.com/sp-api/docs/website-authorization-workflow) — Um fluxo de trabalho de OAuth autorização que é iniciado a partir do seu próprio site.
+ **Aplicativos públicos para fornecedores** — Esses aplicativos estão disponíveis publicamente e são autorizados pelos fornecedores. Você pode usar o [fluxo de trabalho de autorização do site](https://developer-docs.amazon.com/sp-api/docs/website-authorization-workflow). Esse é um fluxo de trabalho de OAuth autorização iniciado em seu próprio site.
+ **Aplicativos privados para vendedores ou fornecedores** — Esses aplicativos estão disponíveis somente para sua organização. Podem ser aplicativos do vendedor ou do fornecedor. Você pode usar a abordagem de [autoautorização](https://developer-docs.amazon.com/sp-api/docs/self-authorization). Ao criar um aplicativo privado para sua própria organização, você pode se autoautorizar a acessar as informações da sua conta. Você pode autoautorizar sua inscrição no status de rascunho; não há motivo para publicar uma inscrição privada. Para obter informações sobre como revogar a autoautorização dos aplicativos do vendedor e do fornecedor, consulte [Revogar autoautorizações](https://developer-docs.amazon.com/sp-api/docs/revoke-self-authorizations-from-your-application) na documentação da SP-API.
### Autorize grupos de fornecedores para acesso a aplicativos
Ao autorizar seu aplicativo Selling Partner API a acessar seus dados, você concede acesso ao grupo de fornecedores associado às credenciais de login da sua conta do Vendor Central. Por extensão, você está concedendo acesso a todos os códigos de fornecedor que estão presentes no grupo de fornecedores. Portanto, é importante usar as credenciais e o grupo de fornecedores corretos da Central de Fornecedores para sua integração com a API do Selling Partner.
O *grupo de fornecedores* é a conta na qual você faz login. Dependendo de seus contratos comerciais, modelos operacionais e outros fatores, seu grupo de fornecedores pode incluir um ou mais códigos de fornecedor. Cada *código de fornecedor* permite que você liste produtos em uma categoria específica ou inclui os contratos comerciais necessários, como um código de fornecedor para uma marca específica.
Você pode [ter várias autorizações](https://developer-docs.amazon.com/sp-api/docs/authorize-vendor-groups-for-application-access#use-multiple-vendor-groups-to-authorize-an-application) para cada grupo de fornecedores ou criar um [único grupo de fornecedores](https://developer-docs.amazon.com/sp-api/docs/authorize-vendor-groups-for-application-access#use-a-single-vendor-group-to-authorize-an-application) que contenha todos os seus códigos de fornecedor. A opção de usar vários grupos de fornecedores associados ao seu perfil permite que você use um aplicativo com o mesmo código de fornecedor em diferentes grupos de fornecedores. Com essa opção, você não precisa enviar vários aplicativos de desenvolvedor de fornecedores para cada grupo de fornecedores.
Para obter mais informações, consulte [Autorizar grupos de fornecedores para acesso ao aplicativo na documentação](https://developer-docs.amazon.com/sp-api/docs/authorize-vendor-groups-for-application-access) do SP-API.
## Conecte-se ao SP-API
Depois de registrar e autorizar sua inscrição, você pode começar a fazer solicitações. Para obter mais informações, consulte [Conexão com a API do parceiro de vendas](https://developer-docs.amazon.com/sp-api/docs/connecting-to-the-selling-partner-api) na documentação da SP-API.