Pular para o conteúdo
Entrar Lista de espera
Docs/Referência da API/Uso e log/Log de requisições

Log de requisições

GET /v1/usage/log escopo read

Log das requisições, da mais nova para a mais antiga, guardado por 30 dias; só metadados (método, rota sem ids, status, duração, chave), nunca corpos, cabeçalhos nem query. Filtros: key (id ou session), status (2xx, 3xx, 4xx, 5xx ou um código), route (trecho), method, days (1 a 30); limit (1 a 200, padrão 50) e cursor (o next da página anterior).

CabeçalhosAuthorization: Bearer praeko_… e X-Praeko-Contract: en. Sempre envie os dois.

Parâmetros

Nome Onde Descrição
key consulta Id de uma chave ou session (o painel).
status consulta 2xx, 3xx, 4xx, 5xx ou um código.
route consulta Trecho da rota.
method consulta Método HTTP.
days consulta Quantos dias olhar (1 a 30).
limit consulta Itens por página (1 a 200). Padrão: 50.
cursor consulta O next da página anterior.

Exemplo

curl "https://praeko.app/v1/usage/log" \
  -H "Authorization: Bearer $PRAEKO_KEY" \
  -H "X-Praeko-Contract: en"

Resposta

Status de sucesso Quando
200 Sucesso.
Resposta 200
{
  "records": [
    {
      "id": "01KA3Z5Q8R2WJ7CX4DN9VB6T1H",
      "method": "POST",
      "route": "/v1/posts",
      "status": 201,
      "durationMs": 212,
      "key": "01KA3Y1B9E5MK7PR3XD0V4SN2G",
      "keyName": "automação do roteiro",
      "createdAt": "2026-11-07T14:02:11.482Z"
    }
  ],
  "next": "01KA3Z5Q8R2WJ7CX4DN9VB6T1H"
}

Só metadados (método, rota sem ids, status, duração, chave); nunca corpo, cabeçalho ou IP. Guardado por 30 dias. next vai em before para a página seguinte; null na última.

Erros

Sem erros específicos desta rota além dos comuns.

Erros de qualquer rota

Status code Quando
401 unauthorized Faltou o cabeçalho Authorization: Bearer ….
401 invalid_api_key A chave não existe.
401 revoked_api_key A chave foi revogada.
401 expired_api_key A chave expirou.
403 forbidden O escopo da chave não basta para esta rota (veja o selo de escopo).
429 rate_limited Passou do limite de requisições por minuto.

O corpo de todo erro é { "error": { "code", "message", "details"? } }. Veja todos os códigos.

Testar

Testar

O teste ao vivo usa a sua chave e a sua conta. Para quem não entrou, fica desligado.

Entre para testar
Dúvida ou erro nesta página? contato@praeko.appVer .md

Digite para buscar páginas, rotas e códigos de erro.