Pular para o conteúdo
Entrar Lista de espera

Resumo de uso

GET /v1/usage escopo read

Uso da API deste workspace nos últimos days (1 a 30, padrão 7, em UTC): total, com sucesso (< 400), erros, duração p95, pico de requisições em um minuto contra o limite por minuto, byDay, byHour (só com days=1: as últimas 24 horas) e byKey (session = o painel).

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

Parâmetros

Nome Onde Descrição
days consulta Quantos dias olhar (1 a 30). Padrão: 7.

Exemplo

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

Resposta

Status de sucesso Quando
200 Sucesso.
Resposta 200
{
  "days": 7,
  "period": {
    "from": "2026-11-01T00:00:00.000Z",
    "to": "2026-11-07T14:02:11.482Z"
  },
  "total": 1842,
  "succeeded": 1790,
  "errors": 52,
  "p95Ms": 180,
  "peakPerMinute": 41,
  "limitPerMinute": 300,
  "byDay": [
    {
      "day": "2026-11-06",
      "total": 312,
      "errors": 4
    },
    {
      "day": "2026-11-07",
      "total": 98,
      "errors": 0
    }
  ],
  "byKey": [
    {
      "id": "01KA3Y1B9E5MK7PR3XD0V4SN2G",
      "name": "automação do roteiro",
      "total": 1842,
      "errors": 52,
      "lastAt": "2026-11-07T14:02:11.482Z"
    }
  ]
}

Dias em UTC; byDay tem um item por dia do período, inclusive os sem requisição.

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.