Referência Rápida
A maioria das integrações precisa de ambos os tipos de chave: uma chave Advanced para sincronização de catálogo, campanhas e relatórios, e uma chave Marketplace para leilões e eventos.
Qual Chave Eu Preciso?
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 uma chave Advanced em um endpoint que requer uma chave Marketplace
- Usando uma chave Marketplace em um endpoint que requer uma chave Advanced
Como Obter Suas Chaves
Marketplace API Key
1
Acessar o Topsort Admin
Faça login no seu painel de administração do Topsort
2
Navegar para Configurações de API
Vá para Configurações → Integração de API
3
Criar Chave API
Clique em “Gerar chave API” e selecione “Marketplace API key”
4
Copiar e Armazenar
Copie a chave imediatamente e armazene-a com segurança (é mostrada apenas uma vez)
Advanced API Key
1
Acessar o Topsort Admin
Faça login no seu painel de administração do Topsort
2
Navegar para Configurações de API
Vá para Configurações → Acesso à API
3
Gerar Chave
Clique em “Gerar Chave” para criar sua chave Advanced API
4
Copiar e Armazenar
Copie a chave e armazene-a com segurança em suas variáveis de ambiente
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