Onde Encontrar os Logs
Navegue até a aba Ferramentas de Desenvolvimento na sua Plataforma de Anúncios Topsort para acessar logs em tempo real da sua chave API.Disponibilidade de Logs
| Ambiente | O Que é Registrado | Retenção |
|---|---|---|
| Staging | Todas as solicitações e respostas da API | 30 dias |
| Produção | Apenas erros e solicitações com falha | 30 dias |
À medida que o uso da sua API de produção aumenta, as solicitações bem-sucedidas podem ser filtradas dos logs para melhorar o desempenho. Erros e informações de depuração sempre estarão disponíveis.
Compreendendo Entradas de Log
Solicitações Bem-Sucedidas
- Status: Códigos de status HTTP 200/201/204
- Timestamp: Quando a solicitação foi feita
- Endpoint: Qual endpoint da API foi chamado
- Tempo de resposta: Quanto tempo a solicitação levou
- Tamanho da solicitação: Tamanho dos dados de solicitação/resposta
Entradas de Erro
- Status: Código de erro HTTP (400, 401, 403, etc.)
- Detalhes do erro: Código de erro específico e mensagem
- Corpo da solicitação: Quais dados foram enviados (para depuração)
- Stack trace: Detalhes internos do erro (quando disponível)
Padrões Comuns de Log
Problemas de Autenticação
Authorization: Bearer SUA_CHAVE_API
Erros de Validação
Limitação de Taxa
Usando Logs para Depuração
1. Eventos Não Aparecem no Painel
Procure por:- Status 200 em chamadas para
/events - Erros de validação no payload do evento
- Problemas de timestamp (
occurredAtno futuro ou muito antigo)
2. Resultados de Leilão Vazios
Verifique:- Status do orçamento da campanha
- Disponibilidade do produto no catálogo
- Formato da solicitação de leilão
3. Problemas de Atribuição
Revise os logs de eventos para:- Uso consistente do ID do usuário
resolvedBidIdapropriado dos leilões- Timing dos eventos de clique/compra
Melhores Práticas
Monitoramento de Logs
- Verifique os logs após implementar novo código de integração
- Monitore taxas de erro durante períodos de alto tráfego
- Configure alertas para padrões de erro recorrentes
Fluxo de Trabalho de Solução de Problemas
- Reproduza o problema no ambiente de staging
- Verifique logs recentes em busca de padrões de erro
- Verifique o formato da solicitação na documentação da API
- Teste com payload mínimo para isolar o problema
- Entre em contato com o suporte com timestamps de log para problemas complexos
Privacidade e Tratamento de Dados
- Os logs podem conter dados sensíveis de suas solicitações
- Os logs de produção expiram automaticamente após 30 dias
- O acesso aos logs é restrito apenas a usuários administradores
- Dados pessoais nos logs seguem políticas padrão de retenção de dados
Precisa de Ajuda?
Se você está vendo erros persistentes nos seus logs:- Anote o timestamp das solicitações problemáticas
- Copie a mensagem de erro exata e os detalhes da solicitação
- Entre em contato com o suporte com essas informações para uma resolução mais rápida