Logs e uso
O painel da API fica em validades.com → Time → API, e só o dono e os administradores da organização têm acesso.
Uso
- Cota do mês: quanto já foi usado, o total e quando renova. A barra fica amarela em 80% e vermelha em 100%.
- Hoje: requisições do dia (UTC).
- Limites: por chave e por organização, por minuto.
- Últimos 30 dias: gráfico de requisições por dia.
- Rotas mais usadas: as 5 rotas com mais requisições, com o tempo médio de resposta.
Os números do mês e do dia são atualizados na hora. O histórico pode levar alguns minutos para aparecer.
Registros de requisições
O painel mostra uma versão resumida de cada requisição dos últimos 90 dias:
| Coluna | O que mostra |
|---|---|
| Data | data e hora da requisição |
| Rota | método e rota (por exemplo PATCH /v1/batches/:id) |
| Status | código HTTP; o código do erro aparece ao passar o mouse |
| Chave | nome e últimos 4 caracteres da chave usada |
| Duração | tempo de resposta |
| IP | endereço de onde veio a requisição |
| ID da requisição | o request_id; clique para copiar |
Você pode filtrar por resultado (sucesso, erro do cliente, limite atingido, negada, erro do servidor) e por chave. Exclusões de loja em cascata aparecem destacadas, com a quantidade de produtos e lotes excluídos.
O painel não mostra o corpo das requisições nem os cabeçalhos. A equipe do Validades tem acesso aos registros completos, para suporte e segurança, conforme os Termos de Uso da API.
Requisições de um IP desconhecido ou em horários estranhos podem indicar que a chave vazou. Nesse caso, revogue a chave na hora. Veja Autenticação.
Registro de atividades
As alterações feitas pela API também aparecem no registro de atividades da organização (Time → Logs) como "Via API (chave "Nome")", ao lado das alterações feitas pelos membros.
E-mails
O dono e os administradores recebem um e-mail quando:
- o acesso à API é liberado, suspenso, recusado ou encerrado;
- uma chave nova é criada;
- a organização usa 80% e 100% da cota do mês;
- uma loja é excluída pela API com
cascade=true; - há uma nova versão dos Termos de Uso da API para aceitar, um lembrete 7 dias antes do prazo e um aviso se a API for bloqueada por falta de aceite.