Pular para o conteúdo principal
GET
Cost Summary
string
Namespace Kubernetes cujo ledger será lido. Vazio agrega o ledger de todos os namespaces.
string
Início da janela, RFC 3339
string
Fim da janela, RFC 3339. from e to formam um período absoluto: com os dois, exatamente [from, to]; só com from, vai até agora; só com to, os 30 dias que terminam em to; sem nenhum, os últimos 30 dias.

Campos do Resumo

Role mínima: viewer. Um namespace que ainda não tem chatcli-cost-ledger responde 200 com totais zerados; qualquer outra falha ao ler o ledger retorna 500 (failed to read the cost ledger: ...) em vez de zeros. Cada chamada de LLM é precificada pela tarifa do próprio modelo no momento do registro e somada ao total do incidente, e registros concorrentes tentam de novo em caso de conflito, então nenhum se perde. A resposta não traz ROI, custo de downtime nem quebra por incidente. O ledger vive em um ConfigMap chatcli-cost-ledger por namespace (localizado pela label app.kubernetes.io/managed-by: chatcli-operator na agregação); veja Capacidade, Ruído e Custo para o formato e o override de preços.

Autorizações

X-API-Key
string
header
obrigatório

API key sent in the X-API-Key header. Keys are read from the Secret chatcli-operator-secrets, key api-keys (fallback: ConfigMap chatcli-operator-config, key api-keys) in the operator namespace, as a YAML list of {key, role, name, description} (name is the identity recorded on approval decisions); the operator chart creates it only with apiKeys.create: true. Roles: viewer < operator < admin — any other role string is denied everywhere. Changes are picked up within about 30 seconds; deleting both the Secret and the ConfigMap revokes every key. With no keys configured every /api/ call returns 401, unless CHATCLI_OPERATOR_DEV_MODE=true, which grants admin without a key (development only).

Parâmetros de consulta

namespace
string

Ledger to read. Empty aggregates every namespace.

from
string<date-time>

Start of the time range (RFC3339). Unparseable values are ignored.

Exemplo:

"2026-03-01T00:00:00Z"

to
string<date-time>

End of the time range (RFC3339). Unparseable values are ignored.

Exemplo:

"2026-03-19T23:59:59Z"

Resposta

Cost summary

apiVersion
string
Exemplo:

"v1"

kind
string
Exemplo:

"CostSummary"

spec
object