Referência Rápida
| Tipo de Chave | Onde | Propósito | Usuário |
|---|---|---|---|
| Marketplace API Key | Configurações de Admin | Todas as operações do marketplace | Servidores backend |
| Advanced API Key | Painel do Vendedor | Campanhas de um único vendedor | Ferramentas do vendedor |
Qual Chave Eu Preciso?
| Endpoint | Tipo de Chave |
|---|---|
POST /v2/auctions | Marketplace |
POST /v2/events | Marketplace |
POST /v2/products | Marketplace |
GET /public/v1/reporting-service/* | Marketplace |
POST /public/v1/campaign-service/* | Qualquer uma (com escopo de vendedor se for chave Advanced) |
GET /public/v1/billing-service/* | Marketplace |
Erros Comuns
401 Unauthorized
- Chave API não incluída no cabeçalho
Authorization - A chave está malformada ou expirada
- Usando chave Advanced em endpoint exclusivo do Marketplace
Authorization: Bearer YOUR_API_KEY
403 Forbidden
- Usando chave Advanced para endpoint que requer chave Marketplace
- Chave Advanced tentando acessar dados de vendedor diferente
Como Obter Suas Chaves
Marketplace API Key
Advanced API Key
Melhores Práticas de Segurança
- Nunca confirme chaves no controle de versão
- Armazene chaves em variáveis de ambiente
- Rotacione as chaves regularmente
- Use chaves diferentes para diferentes ambientes (dev, staging, produção)
- Restrinja o acesso às chaves apenas aos membros da equipe necessários
Escopo de Permissões de Chave
Marketplace API Key
- Acesso completo a todas as operações do marketplace
- Pode criar e gerenciar campanhas para qualquer vendedor
- Acesso a todos os dados de relatórios
- Obrigatória para endpoints de leilão e evento
Advanced API Key
- Limitada aos dados de um vendedor específico
- Pode apenas gerenciar campanhas para o vendedor associado
- Não pode acessar informações de outros vendedores
- Ideal para integrações específicas de vendedor
Last updated: