Referência da API

Consumo

Consumo da própria conta, derivado do log de chamadas: totais, latência, faixas de status e as chamadas mais recentes — nunca dados de terceiros, nunca a chave em claro.

GET/v1/usage

Parâmetros de query

Campo	Tipo	Descrição
recentes	int	Nº de chamadas recentes a retornar (1–50, default 10).

Exemplo

Requisição

curl "https://api.finanseed.com.br/v1/usage?recentes=3" \
  -H "X-API-Key: fs_live_SUA_CHAVE"

Resposta · 200

{
  "client_id": "2f4b7c1e-…",
  "nome": "Minha Empresa",
  "tier": "growth",
  "rate_limit": 600,
  "total_chamadas": 18234,
  "chamadas_24h": 512,
  "latencia": { "p50_ms": 38, "p95_ms": 142 },
  "status": { "sucesso_2xx": 17902, "erro_cliente_4xx": 330, "erro_servidor_5xx": 2 },
  "recentes": [
    {
      "created_at": "2026-08-15T14:02:11Z",
      "status_code": 200,
      "latency_ms": 41,
      "cached": false,
      "rule_id": "BR-MG-SP-NCM2202-ICMSST-v4.1",
      "resumo": "POST /v1/calculate (icms_st)",
      "request": { "tributo": "icms_st", "ncm": "22021000", "uf_origem": "SP", "uf_destino": "MG" }
    }
  ]
}

Notas

rate_limit é o limite efetivamente aplicado pelo gate (plano ou override da conta). O campo request das chamadas recentes é sanitizado na origem — headers e chaves jamais são gravados no log — e passa por uma segunda peneira antes de ecoar aqui. A chamada ao próprio /v1/usage é medida como qualquer outra /v1/*, mas o dashboard completo de consumo (com cota do ciclo e excedente) vive no painel.