> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topsort.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Logs de Desenvolvedor

> Acesse e interprete logs de API na plataforma de administração Topsort

## 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  |

<Note>
  À 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.
</Note>

## Compreendendo Entradas de Log

### Solicitações Bem-Sucedidas

<img src="https://mintcdn.com/topsort/oVmv62U7qVFoTD_d/en/api-reference/5a7e3e4-87895af-Schema-validator-notification.webp?fit=max&auto=format&n=oVmv62U7qVFoTD_d&q=85&s=430bfba5e57697b63ab0eaa29747322a" alt="Captura de tela de notificação do validador de esquema" width="1278" height="951" data-path="en/api-reference/5a7e3e4-87895af-Schema-validator-notification.webp" />

Chamadas de API bem-sucedidas mostram:

* **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

<img src="https://mintcdn.com/topsort/1RZV69Uhic79Ylqv/en/api-reference/bcb6eb0-b5dedc7-Schema-validator-error.webp?fit=max&auto=format&n=1RZV69Uhic79Ylqv&q=85&s=1562f907c238249ec7141353afe2ab00" alt="Captura de tela de erro do validador de esquema" width="1297" height="463" data-path="en/api-reference/bcb6eb0-b5dedc7-Schema-validator-error.webp" />

Solicitações com falha incluem informações adicionais de depuração:

* **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

```
401 Unauthorized - invalid_api_key
Missing Authorization header
```

**Solução:** Adicione o cabeçalho `Authorization: Bearer SUA_CHAVE_API`

### Erros de Validação

```
422 Unprocessable Entity - invalid_product_id
Product 'sku_123' not found in catalog
```

**Solução:** Verifique se o produto existe e está escrito corretamente

### Limitação de Taxa

```
429 Too Many Requests - rate_limited
X-RateLimit-Remaining: 0
```

**Solução:** Implemente lógica de repetição com backoff exponencial

## 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** (`occurredAt` no 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
* `resolvedBidId` apropriado 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

1. **Reproduza o problema** no ambiente de staging
2. **Verifique logs recentes** em busca de padrões de erro
3. **Verifique o formato da solicitação** na [documentação da API](/pt/api-reference)
4. **Teste com payload mínimo** para isolar o problema
5. **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:

1. **Anote o timestamp** das solicitações problemáticas
2. **Copie a mensagem de erro exata** e os detalhes da solicitação
3. **Entre em contato com o suporte** com essas informações para uma resolução mais rápida

Nossa equipe pode acessar logs detalhados do lado do servidor para ajudar a diagnosticar problemas complexos de integração.