Se você estiver integrando com a Amazon como vendedor, afiliado ou anunciante, enfrentará uma decisão crucial: qual API realmente atende às suas necessidades? A Amazon oferece quatro APIs distintas, cada uma criada para casos de uso diferentes.
Com a descontinuação do legado Marketplace Web Services (MWS), todas as integrações modernas da Amazon precisam escolher entre a Selling Partner API, Product Advertising API, Amazon Advertising API e APIs especializadas como a Vendor Central API. Este guia orienta você por todo o ecossistema, desde identificar qual API você precisa até entender métodos de autenticação, para que você possa tomar decisões informadas sobre sua estratégia de integração.
Entender o seu caso de uso é o primeiro passo. Vamos explorar os conceitos-chave, começando pelas aplicações comuns nas APIs da Amazon.
Onde as APIs da Amazon são aplicadas?
O ecossistema de APIs da Amazon atende várias comunidades, cada uma com casos de uso distintos e modelos de negócios diferentes.
Vendedores da Amazon e Operadores Multicanal
Vendedores profissionais contam com a Selling Partner API para gerenciar o estoque entre FBA (Fulfillment by Amazon) e FBM (Fulfillment by Merchant), automatizar estratégias de precificação, gerar relatórios, processar pedidos e reembolsos de forma programática, ou para integrar a Amazon a sistemas ERP, software de contabilidade e plataformas de gestão de estoque.
Afiliados de Marketing e Criadores de Conteúdo
Profissionais de marketing de afiliados e criadores de conteúdo utilizam a API de Publicidade de Produtos para buscar informações de produtos da Amazon, avaliações, preços e disponibilidade para exibir em seus sites. Quer você esteja criando ferramentas de comparação de produtos, agregadores de avaliações ou blogs de nichos, a API viabiliza monetização por meio de estruturas de comissão do Amazon Associates sem venda direta.
Agências de Publicidade e Especialistas em PPC
Agências gerenciando campanhas de publicidade da Amazon em escala usam a Amazon Advertising API para criar, atualizar, pausar e otimizar produtos patrocinados, marcas e anúncios de display de forma programática. A API fornece métricas de desempenho de campanhas em tempo real, capacidades de automação de lances e dados de atribuição que a otimização manual simplesmente não consegue alcançar. Para gerenciar melhor o gasto com anúncios e prever o desempenho das campanhas, muitos anunciantes confiam em uma calculadora de custos de PPC da Amazon para estimar orçamentos, lances e retornos esperados antes de lançar campanhas. Ao gerenciar várias contas de anúncios ou testar campanhas entre regiões, usar ambientes isolados como celulares na nuvem pode ajudar a evitar problemas de vinculação de contas.
Construtores de Plataformas SaaS
Desenvolvedores que constroem soluções SaaS para vendedores da Amazon integram a SP-API para criar painéis de gestão, ferramentas de reprecificação, ferramentas de listagem automatizadas, plataformas analíticas e aplicações específicas do setor. Um exemplo é um SaaS de reprecificação que monitora os preços dos concorrentes e ajusta seus preços automaticamente para manter a competitividade, mantendo as margens de lucro.
Fornecedores e Dropshippers
Fornecedores da Amazon e plataformas de fornecedores especializadas usam APIs dedicadas de fornecedor para gerenciar a cadeia de suprimentos, acessar dados de vendas agregados por catálogo e integrar-se a sistemas de compras. Dropshippers costumam combinar Product Advertising API com SP-API para gerenciar feeds de produtos e pedidos automaticamente.
Entendendo o ecossistema de APIs da Amazon
Em 31 de março de 2024, a Amazon desativou seus endpoints legados MWS, o que significa que toda ferramenta séria para vendedores agora precisa operar na moderna Selling Partner API (SP-API) para continuar puxando pedidos, inventário e dados de pagamento de forma confiável.
Hoje, a Amazon não oferece uma API unificada única — em vez disso, disponibiliza APIs especializadas otimizadas para diferentes fluxos de trabalho. Antes de escolher uma API, você precisa entender o que cada uma faz.
As quatro APIs principais da Amazon
Esta tabela mostra como as APIs SP-API, Product Advertising, Amazon Advertising e Vendor Central diferem em finalidade, cenários ideais, usuários principais e modelos de autenticação, oferecendo a você um filtro inicial claro para sua escolha.
| API | Propósito | Melhor para | Principais usuários | Autenticação |
|---|---|---|---|---|
| API de Parceiro de Vendas (SP-API) | Gestão de pedidos, estoque, listagens e dados financeiros | Vendedores e lojistas: Automação de operações | Vendedores profissionais, fornecedores e desenvolvedores | OAuth 2.0 + LwA (Entrar com a Amazon) |
| API de Publicidade de Produtos | Recuperação de dados de produtos para sites de afiliados | Exibir produtos da Amazon em sites externos | Afiliados, criadores de conteúdo, sites de avaliações | Chave de API + OAuth 2.0 |
| API de Publicidade da Amazon | Gestão de campanhas e desempenho de anúncios | Gerenciando anúncios patrocinados de forma programática | Agências de publicidade, vendedores e gerentes de marca | OAuth 2.0 + LwA |
| Vendor Central API (Propriedade do Vendedor) | Cadeia de suprimentos e relatórios específicos do fornecedor | Cadeia de suprimentos e compras | Apenas vendedores da Amazon | Credenciais AWS ou OAuth |
Cada API opera de forma independente, com autenticação separada, limites de taxa e estruturas de preços distintas. Escolher a certa depende inteiramente do que você está tentando alcançar.
Estrutura de Decisão Rápida
Se você não tem certeza de qual API da Amazon realmente precisa, use este guia rápido antes de mergulhar na documentação. Ele mapeia os objetivos mais comuns para a API certa, para que você não perca tempo integrando a API errada.
Escolher uma API da Amazon fica muito mais fácil quando você a ancora a um objetivo único e concreto. À medida que sua pilha de tecnologia cresce, você pode combinar várias APIs em uma única solução, mas este framework manterá cada integração com uma finalidade clara, em vez de tecnologia por si só. Nas próximas seções, vamos detalhar cada API em detalhes, incluindo capacidades, limitações e como começar.
Selling Partner API (SP-API): a espinha dorsal do vendedor moderno
Em setembro de 2021, a SP-API tornou-se o novo padrão e o sucessor funcional do legado MWS (Marketplace Web Services). Atualmente é a API principal para vendedores da Amazon em todo o mundo e serve como base para operações de venda profissionais.
O que é SP-API?
The Selling Partner API é uma API baseada em REST que oferece aos vendedores da Amazon acesso programático aos seus dados comerciais. Abrange pedidos, remessas, níveis de estoque, listas de produtos, transações financeiras, devoluções e relatórios detalhados. Mais de 1 milhão de vendedores em todo o mundo usam a SP-API para automatizar e ampliar suas operações.
O que você pode fazer com a SP-API?
- Gerenciamento de inventário e listagens. Adicione, atualize ou exclua listagens de produtos programaticamente, gerencie o estoque entre várias SKUs e marketplaces, e envie atualizações em massa para catálogos grandes em vez de editar tudo manualmente em Seller Central.
- Processamento de Pedidos e Envios. Recupere pedidos em tempo real, confirme envios, atualize números de rastreamento, trate cancelamentos e reembolsos, e gere etiquetas de embalagem para que os pedidos fluam diretamente do Amazon para o seu centro de distribuição.
- Automação de precificação. Ajuste os preços automaticamente com base no nível de estoque, velocidade de vendas, atividade da concorrência ou tendências de mercado, usando lógica de repricing que pode otimizar milhares de SKUs em tempo real.
- Dados financeiros e relatórios. Gere relatórios detalhados sobre desempenho de vendas, tráfego, envelhecimento de estoque, recomendações de reabastecimento e eventos financeiros sem baixar CSVs manualmente, permitindo análises atualizadas em seus painéis.
- Devoluções, reembolsos e integrações externas. Automatize o fluxo de devoluções (detalhes, etiquetas, reembolsos) e sincronize a Amazon com ERP, CRM, contabilidade e sistemas de envio para que dados operacionais se movam entre as ferramentas sem entrada manual de dados.
Guia rápido: Sua primeira chamada SP-API (Python)
Aqui está um exemplo mínimo para recuperar seus pedidos recentes:
import requests
from datetime import datetime, timedelta
access_token = "YOUR_ACCESS_TOKEN"
region = "us-east-1"
headers = {
"Authorization": f"Bearer {access_token}",
"Content-Type": "application/json"
}
created_after = (datetime.utcnow() - timedelta(days=7)).isoformat() + "Z"
url = "https://sellingpartnerapi-na.amazon.com/orders/v0/orders"
params = {
"CreatedAfter": created_after,
"OrderStatuses": "Unshipped,PartiallyShipped,Pending"
}
response = requests.get(url, headers=headers, params=params)
if response.status_code == 200:
orders = response.json()
print(f"Retrieved {len(orders['Orders'])} orders")
for order in orders["Orders"]:
print(f"Order {order['AmazonOrderId']}: ${order['OrderTotal']['Amount']}")
else:
print(f"Error: {response.status_code} - {response.text}")
Limites de Taxa da SP-API por Operação
Operações diferentes da SP-API possuem limites de taxa distintos. Veja o que você precisa saber:
| Operação | Limite de Requisições | Burst | Caso de Uso | Impacto |
|---|---|---|---|---|
| GetOrder | 0,5 req/seg | 1 | Obter detalhes de um pedido | Melhor para consultas de pedidos em tempo real |
| Listar Pedidos | 0,5 req/seg | 1 | Buscar lote de pedidos | Sincronize pedidos diariamente |
| GetInventorySummaries | 2 req/seg | 10 | Verificar níveis de estoque | Monitore o estoque por SKU |
| Atualizar Inventário | 2 req/seg | 5 | Ajustar quantidades em estoque | Atualizações em lote recomendadas |
| GetListingOffersBatch | 0,1 req/seg | 1 | Consultar preços/ofertas | Operação mais restritiva |
| PutProduct | 10 req/sec | 10 | Criar/atualizar listagens | Bulk listing operations |
| Criar Remessa de Entrada | 2 req/seg | 10 | Criação de envio FBA | Gerencie a logística de entrada |
Ponto-chave: GetListingOffersBatch é o mais restritivo (0,1 req/seg), então as verificações de precificação exigem controle cuidadoso de requisições. Use operações em lote sempre que possível.
Limitações da SP-API e Considerações Importantes
Embora a Selling Partner API seja extremamente poderosa, ela traz várias limitações práticas que você deve planejar antes de integrá-la ao seu stack.
| Aspecto | O que saber | O que isso significa para você |
|---|---|---|
| Requisitos de cadastro | Você precisa de uma conta de vendedor Profissional com um plano de venda Profissional ativo para acessar a SP-API. | Defina o orçamento do plano mensal e confirme o status da sua conta antes de começar a criar ou testar. |
| Limitação de taxa | SP-API impõe limites de requisições por operação; excedê-los aciona respostas de limitação de taxa (HTTP 429). | Implemente enfileiramento de requisições, processamento em lote quando possível e backoff exponencial para evitar falhas sob carga. |
| Restrições regionais | Credenciais estão vinculadas a marketplaces individuais (por exemplo, amazon.com vs amazon.co.uk). | Para configurações multirregionais, você precisará de credenciais distintas e lógica de roteamento por marketplace. |
| Ambiente sandbox | A Amazon oferece um endpoint sandbox para testes em ambiente de não produção. | Use o sandbox para o desenvolvimento inicial e testes de regressão, para não arriscar pedidos reais ou dados de conta. |
Se você planejar sua integração desde o primeiro dia levando esses limites em consideração, sua implementação da SP-API ficará muito mais estável, escalável e fácil de manter à medida que seu negócio na Amazon cresce.
Product Advertising API: A Ferramenta do Marketer de Afiliados
A Product Advertising API permite que afiliados obtenham dados de produtos da Amazon para exibição em sites externos. Ela foi criada especificamente para Amazon Associates que desejam buscar programaticamente informações de produtos, avaliações, preços e disponibilidade.
What Is Product Advertising API?
A API de Publicidade de Produtos fornece acesso somente leitura ao catálogo de produtos da Amazon. Você pode pesquisar produtos usando palavras-chave, obter informações detalhadas do produto, incluindo título, descrição, imagens, preços, disponibilidade e avaliações de clientes. É essencial que todos os dados obtidos sejam exibidos em um site — a API não foi projetada para raspagem de dados em grande escala ou análise offline. Se você precisa de extração de dados crus sem essas regras rígidas de exibição, uma API dedicada API de raspagem da Amazon é mais adequada.
O que você pode fazer com a Product Advertising API?
- Pesquisa de Produtos. Pesquise no catálogo da Amazon por palavras-chave e obtenha produtos correspondentes com detalhes-chave, ideal para blocos de produtos dinâmicos que se atualizam com base no que os usuários pesquisam.
- Recupere detalhes ricos do produto. Carregue metadados completos de itens específicos, incluindo título, descrição, imagens, marca, avaliações, contagem de avaliações, preço e ASIN, para que você possa criar cartões de produto detalhados e tabelas de comparação.
- Busque avaliações de clientes. Obtenha o texto das avaliações, as notas, as datas e os nomes dos avaliadores para alimentar widgets de avaliações, seções de depoimentos ou páginas independentes de agregação de avaliações em seu site.
- Verifique disponibilidade e preços. Acesse preços e disponibilidade em tempo quase real, o que é essencial para sites de comparação que precisam mostrar se o item está disponível ou fora de estoque temporariamente.
- Crie experiências de compra completas. Crie fluxos de compra com carrinhos, traga ofertas de vários vendedores para o mesmo produto e envie usuários para a Amazon com links de rastreamento para que as comissões de afiliados sejam atribuídas corretamente.
Início rápido: Pesquisa de Produtos em Node.js
Aqui está um exemplo simples para procurar produtos:
de>const axios = require("axios"); const partnerId = "YOUR_PARTNER_TAG"; const apiKey = "YOUR_API_KEY"; const apiHost = "webservices.amazon.com"; async function searchProducts(keyword) { const endpoint = "/paapi5/searchitems"; const payload = { Keywords: keyword, PartnerTag: partnerId, PartnerType: "Associates", SearchIndex: "All", Resources: [ "Images.Primary.Medium", "ItemInfo.Title", "Offers.Listings.Price", "CustomerReviews.Count", "CustomerReviews.StarRating" ] }; try { const response = await axios.post( `https://${apiHost}${endpoint}`, payload, { headers: { "Content-Type": "application/json", "X-API-Key": apiKey } } ); const products = response.data.SearchResult.Items; console.log(`Found ${products.length} products for "${keyword}"`); products.forEach((item) => { console.log(`- ${item.ItemInfo.Title.DisplayValue}`); console.log( ` Price: $${item.Offers.Listings[0].Price.DisplayPrice}` ); console.log( ` Rating: ${item.CustomerReviews.StarRating.DisplayValue}★` ); }); } catch (error) { console.error( `Error: ${error.response.status} - ${error.response.data.Errors[0].Message}` ); } } searchProducts("best gaming headphones");
Limitações da API de Publicidade de Produtos e Considerações Importantes
Antes de começar a trabalhar com a Product Advertising API, certifique-se de entender estas limitações para que sua integração de afiliados não encontre surpresas.
| Aspecto | O que saber | O que isso significa para você |
|---|---|---|
| Aprovação do Amazon Associates | Você precisa de uma conta ativa do Amazon Associates que tenha sido aprovada há pelo menos 30 dias e tenha gerado um número mínimo de vendas qualificadas. | Você não pode confiar nesta API para um site novo; reserve tempo para atrair tráfego e conversões iniciais antes do desenvolvimento. |
| Acesso somente leitura | A API retorna apenas dados do catálogo; não pode criar, atualizar ou excluir listagens. | Use-o para dados de produto e links, não para gerenciar inventário ou ofertas na Amazon. |
| Limites de uso | Aplicam-se quotas diárias de solicitações (100.000 requisições a cada 24 horas). Planos de nível superior disponíveis para afiliados bem-sucedidos. | Armazene dados de produto em cache, agrupe chamadas e monitore o volume de requisições para não ultrapassar limites em dias de pico. |
| Requisitos de exibição | Os dados devem ser exibidos em um site público com atribuição adequada e mantidos razoavelmente atualizados. | Não utilize a API apenas para análise offline ou para republicar dados em canais não conformes ou em ferramentas fechadas. |
| Restrições geográficas | O acesso está vinculado a programas de Associados regionais específicos e aos países suportados. | Se você mira em várias regiões, pode ser necessário ter contas associadas separadas e configurar cada localidade. |
Projete sua integração levando estas regras em mente, e a API de Publicidade de Produtos permanecerá estável, em conformidade e escalável à medida que o tráfego de afiliados cresce.
Amazon Advertising API: A Escolha do Gerente de Campanha
A API de Publicidade da Amazon permite a gestão programática de campanhas de anúncios patrocinados de produtos, marcas e display. Foi projetada para agências, vendedores e plataformas que gerenciam publicidade em escala.
O que é a Amazon Advertising API?
The Amazon Advertising API oferece acesso programático às suas contas de publicidade. Você pode criar e gerenciar campanhas, ajustar lances e orçamentos, recuperar métricas de desempenho detalhadas e otimizar os gastos com publicidade automaticamente. Ao contrário da gestão manual de campanhas no Console de Publicidade, a API permite otimização em tempo real com base em dados de desempenho reais.
O que você pode fazer com a API de Publicidade da Amazon?
- Gestão de campanhas. Crie campanhas novas, pause as de baixo desempenho, reinicie-as quando as condições melhorarem e ajuste segmentação, orçamentos e cronogramas de forma programática.
- Otimização de lances. Ajuste lances automaticamente com base em métricas como impressões, cliques, conversões ou ACoS, para que palavras-chave de alto desempenho recebam mais orçamento e as de baixo desempenho recebam menos orçamento.
- Relatórios de Desempenho. Extraia relatórios detalhados com impressões, cliques, despesas, conversões e receita em níveis de campanha, grupo de anúncios e palavras-chave para alimentar painéis de controle e alertas personalizados.
- Gestão de múltiplas contas. Gerencie campanhas para várias marcas ou clientes a partir de um único sistema, aplique regras globais de otimização e padronize relatórios entre contas.
- Insights de Atribuição. Use dados de atribuição para conectar fontes de tráfego fora da Amazon (busca, redes sociais, e-mail) às vendas na Amazon resultantes e entender o ROI de todo o funil.
Início rápido: Buscar o Desempenho da Campanha (Python)
de>import requests from datetime ...
Limitações da API de Publicidade da Amazon e Considerações Importantes
Como acontece com outras APIs da Amazon, a Advertising API tem regras de acesso próprias e limitações técnicas que você deve considerar ao planejar suas ferramentas de campanha.
| Aspecto | O que saber | O que isso significa para você |
|---|---|---|
| É necessária uma conta de publicidade. | É preciso ter uma conta ativa de Publicidade da Amazon com pelo menos uma campanha aprovada. | Configure e valide as campanhas no console primeiro; depois implemente a API para automação. |
| Limitação de taxa | A API limita as requisições a 10 por segundo. Ultrapassar esse limite resulta em respostas HTTP 429. | Implemente processamento em lote, intervalo de recuo (backoff) e agendamento para que as tarefas de relatório e de otimização não fiquem limitadas. |
| Separação Regional | Credenciais e entidades ficam vinculadas a um marketplace específico (por exemplo, EUA vs. UE). | Relatórios entre regiões ou a gestão entre regiões exigem que as credenciais e entidades de cada região sejam gerenciadas separadamente. |
| Janela histórica limitada | A API normalmente fornece dados de desempenho dos últimos 60 dias. Dados mais antigos exigem o uso da funcionalidade de Relatórios da Amazon. | Armazene dados em seu próprio armazenamento se precisar de análises de tendências a longo prazo além da janela de histórico nativa. |
Ao planejar essas limitações com antecedência, você pode criar uma pilha de automação de publicidade estável, mesmo com o aumento de gastos, tráfego e do número de contas gerenciadas.
Vendor Central API e outras APIs especializadas
Se você for um Fornecedor da Amazon (e não um Vendedor), suas necessidades de integração diferem significativamente. Fornecedores da Amazon operam com um modelo de negócios diferente, no qual a Amazon compra estoque diretamente de você.
API da Vendor Central
The Vendor Central API oferece capacidades de gerenciamento da cadeia de suprimentos, incluindo ordens de compra, faturas, rastreamento de remessas e gerenciamento de inventário. É projetada exclusivamente para Vendedores da Amazon e utiliza métodos de autenticação diferentes do SP-API.
Principais recursos
- Ver e gerenciar pedidos de compra recebidos da Amazon
- Rastreie o status de envio e informações de entrega
- Obter relatórios financeiros no nível do catálogo
- Gerencie envios de faturas e o rastreamento de pagamentos
- Monitorar métricas de estoque
O acesso à API de Fornecedor requer convite do seu Gerente de Fornecedor da Amazon. O acesso não é autogerenciado como a SP-API — você precisa trabalhar com o seu Gerente de Negócios de Fornecedor para configurar as credenciais.
Métodos de Autenticação e Como Começar
Todas as APIs da Amazon exigem autenticação, mas os métodos variam conforme a API que você está usando.
SP-API: OAuth 2.0 + Entrar com a Amazon
A SP-API usa OAuth 2.0, combinado com o Login com a Amazon (LwA), para autorização segura.
Como Funciona
- Sua aplicação redireciona o vendedor para a página de autorização da Amazon.
- O vendedor faz login e concede permissões ao seu aplicativo.
- Amazon retorna um código de autorização
- Seu app troca o código por um token de acesso.
- Use o token em todas as requisições de API
Getting Started
Visite https://developer.amazonservices.com/register e siga estes passos:
- Crie uma conta de vendedor (Plano Profissional necessário)
- Cadastre-se como desenvolvedor no Seller Central
- Crie uma função IAM na AWS
- Registre seu aplicativo e obtenha suas credenciais LwA
- Implemente o fluxo OAuth em sua aplicação
Product Advertising API: Chave de API
A Product Advertising API usa um método de autenticação com chave de API mais simples.
Getting Started
- Certifique-se de ter uma conta ativa e aprovada do Amazon Associates.
- Já se passaram mais de 30 dias desde a sua primeira aprovação.
- Pelo menos 3 comissões obtidas
- Visite https://affiliate-program.amazon.com/
- Vá para Ferramentas → Product Advertising API
- Copie sua chave de API
- Comece a fazer solicitações com sua chave
API de Publicidade da Amazon: OAuth 2.0
A API de Publicidade da Amazon também usa OAuth 2.0 para autenticação.
Getting Started
- Cadastre-se em https://advertising.amazon.com/
- Vá para as configurações do console de anúncios
- Obter credenciais de acesso à API
- Escolha OAuth 2.0 e siga o fluxo de autorização
- Use tokens retornados para chamadas de API
Na prática, as três APIs seguem a mesma ideia central: seu app nunca se conecta à Amazon de forma anônima. Quer use tokens OAuth ou uma chave de API, você se autentica primeiro e, em seguida, chama os endpoints permitidos pelas suas credenciais. Uma vez que essa base esteja no lugar, você pode se concentrar em construir recursos em vez de se preocupar com detalhes de autenticação de baixo nível.
Preços e Custos da Amazon API (2025-2026)
Preços da API de Parceiro de Vendas
Esta assinatura cobre acesso ao Portal do Provedor de Soluções, suporte e uso ao vivo da SP-API, com cobrança iniciando na primeira chamada de produção do desenvolvedor ou na data de início especificada para contas existentes.
A partir de 30 de abril de 2026, a Amazon adiciona uma taxa mensal com base no volume de chamadas GET, com quatro faixas de uso (Basic, Pro, Plus, Enterprise) e uma camada Basic gratuita. Desenvolvedores podem visualizar as cobranças esperadas em uma ferramenta de pré-visualização de tarifas e recebem aviso com seis meses de antecedência, além de orientações de otimização de chamadas para reduzir chamadas desnecessárias e manter as taxas mais baixas.
| Nível | Chamadas GET mensais incluídas | Mensalidade | Custo adicional |
|---|---|---|---|
| Básico | 2,5 milhões | $0 | $0,40 por 1.000 chamadas |
| Pro | 25 milhões | $1.000 | $0,40 por 1.000 chamadas |
| Mais | 250 milhões | $10,000 | $0,40 por 1.000 chamadas |
| Enterprise | Personalizado | Personalizado | Contato com a Amazon |
Principais pontos
- Todos os desenvolvedores ficam no plano Básico por padrão
- Requisições PUT, PATCH e POST são ilimitadas (sem limites, sujeitas a limites de taxa)
- Apenas as requisições GET contam para sua cota mensal
- Cobranças por excedente são cobradas quando você excede as chamadas incluídas no seu plano
Guia de Tratamento de Erros e Solução de Problemas
Mesmo integrações bem projetadas podem apresentar falhas. Veja como lidar com os erros comuns da API da Amazon:
Códigos de Status HTTP e Soluções
| Código de Status | Tipo de Erro | Significado | Solução |
|---|---|---|---|
| 400 | Solicitação inválida | Solicitação inválida (JSON inválido, campos obrigatórios ausentes) | Verifique a carga da sua requisição; valide de acordo com a documentação da API |
| 401 | Não autorizado | Token de autenticação inválido ou expirado. | Atualize seu token OAuth e verifique as credenciais. |
| 403 | Proibido | Você não tem permissão para esta operação. | Verifique se o seu app possui os escopos necessários; verifique o status da conta do vendedor. |
| 404 | Não encontrado | Recurso não encontrado (pedido/ASIN não encontrado) | Verifique se o ID do recurso está correto e se ele existe |
| 429 | Muitas Solicitações | Limite de requisições atingido | Implemente backoff exponencial; verifique seus limites de plano; considere atualizar. |
| 500 | Erro Interno do Servidor | Os servidores da Amazon encontraram um erro | Tente novamente após 30 segundos; verifique o Status de Serviço da Amazon; entre em contato com o suporte se o problema persistir. |
| 503 | Serviço Indisponível | O serviço da Amazon está temporariamente indisponível | Espere 5–10 minutos; confira a página de status; tente novamente com atraso progressivo |
Na prática, a maioria dos problemas se resume a alguns padrões: entrada ruim (400s), autenticação ausente ou inválida (401/403), limites de taxa (429) ou problemas temporários na plataforma do lado da Amazon (500/503). Se você centralizar o tratamento de erros, registrar as respostas e aplicar regras consistentes de tentativas com intervalos de espera, poderá transformar esses códigos em sinais previsíveis em vez de emergências de produção.
Dicas rápidas de Otimização para APIs da Amazon
Depois de escolher a API da Amazon adequada, algumas técnicas simples de otimização podem reduzir drasticamente o volume de chamadas, acelerar as respostas e manter sua integração dentro de limites de custo e de taxa aceitáveis.
- Solicite apenas o necessário. Use filtros de campo e escopos mais restritos, em vez de puxar dados completos para cada pedido ou produto.
- Adicione cache inteligente. Armazene dados estáveis por horas e dados que mudam rapidamente por minutos para reduzir chamadas repetidas de painéis e relatórios.
- Processar em lote sempre que possível. Prefira endpoints em lote que aceitem várias IDs em uma única requisição, em vez de chamadas de item único.
- Gerencie limites de taxa com tranquilidade. Em HTTP 429, aumente os atrasos entre as tentativas em vez de tentar novamente imediatamente.
- Acompanhe seu uso. Monitore o volume de chamadas, a latência e as taxas de erro, e configure alertas antes de atingir limites rígidos ou faixas de excedente.
- Use eventos em vez de polling. Sempre que possível, substitua padrões de checagem a cada minuto por webhooks/notificações para reduzir o tráfego de API desnecessário.
Perguntas comuns sobre APIs da Amazon
Abaixo estão algumas das perguntas mais frequentes sobre as APIs da Amazon:
Posso usar várias APIs da Amazon juntas?
Qual API é mais fácil de implementar?
As APIs da Amazon custam dinheiro?
O que acontece se eu exceder os limites de taxa?
Posso ampliar o uso da minha API?
Preciso de uma conta de vendedor profissional para SP-API?
Posso usar a Product Advertising API apenas para raspagem de dados ou apenas para ferramentas internas?
Se você precisa de mais orientações, o Amazon Developer Center reúne em um único lugar toda a documentação de Selling Partner, Advertising e Associates, enquanto o Seller Central Help Center cobre questões de Conta, Política e Operações das quais depende a sua integração de API.
Avançar
Se você automatiza suas operações de venda na Amazon, cria fluxos de renda de afiliados, gerencia campanhas publicitárias em escala ou desenvolve ferramentas SaaS para o ecossistema da Amazon, a API certa desbloqueia ganhos significativos de eficiência e oportunidades de receita.
