Saltar para o conteúdo principal
GET
Obter uso de faturamento
Retorna contadores de uso medidos para o período de faturamento atual. Cada contador rastreia um recurso faturável e mostra o quanto você consumiu em relação ao limite do seu plano.

Resposta

Retorna um array de objetos de contador de uso.
string
O identificador da métrica de uso (por exemplo, attestations.mint, verifications_monthly, storage_bytes).
integer
Valor consumido no período de faturamento atual.
integer
Máximo permitido para esta métrica em seu plano. Um valor de -1 indica que não há cota configurada para esta métrica; os limites de serviço e taxa ainda se aplicam.
string
Período de faturamento para este contador: monthly ou total.
string
Unidade de medida: count ou bytes.
boolean
Se o locatário está atualmente autorizado a consumir mais desta métrica. Retorna false quando o limite foi atingido. Incluído apenas quando relevante.
integer
Mudança no uso desde a última consulta. Incluído apenas quando o servidor rastreia atualizações incrementais.

Métricas rastreadas

O endpoint de uso retorna até 16 métricas organizadas por grupo de produto. Quais métricas aparecem depende do seu plano e dos recursos ativos.

Principal

MAIP (Identidade da Máquina)

IA

Antifraude

Para verificar se uma operação específica é permitida antes de executá-la, use o endpoint de direitos para verificar suas cotas.

Painel do Console

Você também pode visualizar o uso graficamente no console em Configurações > Cobrança > Uso. O painel mostra todas as 16 métricas organizadas por grupo de produtos (Core, MAIP, AI e Anti-Fraude), cada uma exibida como uma barra de progresso em relação ao limite do seu plano. Um custo mensal projetado é calculado com base no seu consumo atual e nas taxas efetivas por unidade.

Autorizações

X-API-Key
string
header
obrigatório

Chave de API para autenticação máquina a máquina

Parâmetros de consulta

period
string

Período de faturamento (por exemplo, "2026-04")

Resposta

Dados de uso

period
string
usage
object