Logs de Entrada (Tráfego/Audit)
Visão Geral
O Log de Entrada (também chamado de Tráfego ou Audit) permite que desenvolvedores e administradores acompanhem chamadas feitas às APIs da plataforma.
Você pode acessá-lo em: Partner's Portal > Tráfego
A funcionalidade fornece visibilidade sobre solicitações, respostas, headers, tempos de resposta e status codes.
⚠️ Atenção:
Este recurso tem caráter de auditoria e monitoramento. Não deve ser utilizado como mecanismo transacional ou fonte de dados persistente.
Retenção e Limitações
- Retenção dos logs: 90 dias.
- Persistência: não é garantida em 100% das chamadas (falhas de rede e indisponibilidades podem impactar).
- Finalidade: uso para auditoria, depuração e suporte. Não indicado para integrações críticas.
Recomenda-se que aplicações que necessitem de persistência total implementem mecanismos próprios de logging.
Estrutura do Painel
1. Lista de Requisições
Na tela principal de Tráfego, cada linha corresponde a uma requisição. Campos disponíveis:
| Campo | Descrição |
|---|---|
| Data da Requisição | Horário UTC da chamada |
| Caminho | Endpoint chamado (ex: /v1/requests/{id}/items/approvers) |
| Método | Tipo da operação (GET, POST, PUT, DELETE) |
| ID de Correlação | Identificador único para rastrear a requisição ponta a ponta |
| Status da Resposta | Código HTTP retornado (200, 404, 500, etc.) |
2. Detalhes da Requisição
Ao expandir uma linha, é exibido o painel com Solicitação e Resposta.
Aba Solicitação
Mostra os dados enviados ao servidor:
| Campo | Descrição |
|---|---|
x-me-tenant-id | Identificador do tenant |
authorization | Token de autenticação (mascarado) |
postman-token | Token de rastreio de client |
x-me-correlation-id | ID de correlação |
host | Host da API |
user-agent | Agente de requisição (ex.: PostmanRuntime, libs, apps) |
cache-control | Política de cache |
accept | Tipos aceitos |
accept-encoding | Compressão aceita |
| Endpoint completo | Caminho + parâmetros de query (ex.: ?pageNumber=1&pageSize=10) |
Aba Resposta
Mostra os dados devolvidos pelo servidor:
| Campo | Descrição |
|---|---|
content-type | Formato da resposta (ex.: application/problem+json) |
server | Identificador do servidor |
transfer-encoding | Se chunked ou não |
date | Data/hora da resposta |
connection | Estado da conexão |
ratelimit-limit | Limite máximo de chamadas permitidas |
ratelimit-remaining | Chamadas restantes no período |
ratelimit-reset | Tempo em segundos para reset da janela de limite |
| Response Time | Tempo total da resposta (ex.: 33.7s) |
| Response Size | Tamanho da resposta em bytes |
| Response Body | Corpo retornado pela API (mensagens de erro, payloads, dados) |
Exemplos de Resposta
Erro 500 (Internal Server Error)
{
"type": "https://datatracker.ietf.org/doc/html/rfc7231#section-6.6.1",
"title": "An error occurred while processing your request.",
"status": 500,
"detail": "An unexpected error has occurred. Please try again later or contact support if the issue persists."
}Erro 404 (Not Found)
- Indica que o recurso solicitado não existe (ex.: usuário ou item inexistente).
Sucesso 200 (OK)
- Indica que a requisição foi processada corretamente, com payload retornado no Response Body.
Boas Práticas de Uso
- Utilize o ID de Correlação ao abrir chamados de suporte.
- Monitore picos de erro 500 e excedentes de rate limit como indicadores de saúde da integração.
- Caso precise auditar além dos 90 dias, configure um pipeline de exportação de logs para armazenagem própria.
- Use os status codes e mensagens de erro como primeira camada de troubleshooting.