Saltar para o conteúdo principal

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:

ColunaO que mostra
Datadata e hora da requisição
Rotamétodo e rota (por exemplo PATCH /v1/batches/:id)
Statuscódigo HTTP; o código do erro aparece ao passar o mouse
Chavenome e últimos 4 caracteres da chave usada
Duraçãotempo de resposta
IPendereço de onde veio a requisição
ID da requisiçãoo 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.

Detectando uma chave vazada

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.