Skip to main content
GET
Obter Uso do Projeto

Visão Geral

Retorna uma visão completa do consumo de créditos de um projeto para o ciclo de faturamento atual, incluindo créditos restantes, detalhes do plano de assinatura e um detalhamento das solicitações por tipo de serviço (RPC, DAS, gRPC, WebSocket, etc.).

Parâmetros da Solicitação

string
obrigatório
O ID do projeto para o qual deseja recuperar o uso. Deve corresponder ao projeto associado à chave da API utilizada para autenticação.

Campos de Resposta

number
Créditos restantes no ciclo de faturamento atual. Calculados como o limite de crédito do plano menos os créditos consumidos regularmente, arredondados para zero.
number
Total de créditos consumidos no ciclo de faturamento atual, incluindo créditos regulares e pré-pagos.
number
Créditos pré-pagos ainda disponíveis.
number
Créditos pré-pagos consumidos no ciclo de faturamento atual.
object
Informações do plano de assinatura e ciclo de faturamento.
string
Data de início do ciclo de faturamento no formato YYYY-MM-DD.
string
Data de término do ciclo de faturamento no formato YYYY-MM-DD.
number
Limite total de créditos para o ciclo de faturamento com base no seu plano.
string
Nome do plano de assinatura (ex: "business", "professional").
object
Consumo de créditos por produto para o ciclo de faturamento atual, em créditos inteiros. Abrange todos os produtos. Os valores são acumulados brutos e arredondados uma vez no final para corresponder ao faturamento, portanto, os créditos por produto podem não somar exatamente para creditsUsed após o arredondamento.
number
Créditos consumidos pelo Solana RPC padrão.
number
Créditos consumidos pela Enhanced API (ex: transações analisadas, metadados de token).
number
Créditos consumidos pela Wallet API.
number
Créditos consumidos pela API DAS (Digital Asset Standard).
number
Créditos consumidos por Webhooks.
number
Créditos consumidos pela LaserStream gRPC (medição de largura de banda).
number
Créditos consumidos pela LaserStream WebSocket (medição de largura de banda).
number
Créditos consumidos por Pré-confirmações.
number
Créditos consumidos por Arquivamento.
number
Créditos consumidos pelo Photon (ZK Compression).
number
Créditos consumidos por uso não categorizado.
object
Contagem de solicitações para o ciclo de faturamento atual, apenas para produtos com medição de solicitações. Os produtos LaserStream com medição de largura de banda (laserstreamGrpc, laserstreamWebsocket) não aparecem aqui — veja dataTransfer. Campos: rpc, enhancedApi, walletApi, das, webhooks, preConfirmations, archival, photon, other.
object
Bytes transferidos para o ciclo de faturamento atual, apenas para os produtos LaserStream com medição de largura de banda. Esses produtos são cobrados pelo volume de dados transferidos, não pela contagem de solicitações, então aparecem aqui e em credits mas nunca em requests. Campos: laserstreamGrpc, laserstreamWebsocket.

Parâmetros da Solicitação

string
obrigatório
O ID do projeto para o qual deseja recuperar o uso. Deve corresponder ao projeto associado à chave da API.

Autorizações

api-key
string
query
obrigatório

Chave de API passada como um parâmetro de consulta.

Parâmetros de caminho

id
string<uuid>
obrigatório

O ID do projeto para recuperar uso. Deve corresponder ao projeto associado à chave de API.

Exemplo:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

Resposta

Uso do projeto recuperado com sucesso.

creditsRemaining
number

Número de créditos restantes no ciclo de cobrança atual. Calculado como creditsLimit - regularCreditsUsed, com piso em 0.

Exemplo:

487500

creditsUsed
number

Total de créditos consumidos no ciclo de cobrança atual, incluindo tanto créditos regulares quanto pré-pagos.

Exemplo:

12500

prepaidCreditsRemaining
number

Número de créditos pré-pagos restantes.

Exemplo:

50000

prepaidCreditsUsed
number

Número de créditos pré-pagos consumidos no ciclo de cobrança atual.

Exemplo:

0

subscriptionDetails
object

Detalhes sobre o plano de assinatura do projeto e o ciclo de cobrança atual.

credits
object

Consumo de crédito por produto para o ciclo de cobrança atual, em créditos inteiros. Abrange todos os produtos. Os valores são acumulados em bruto e arredondados apenas no final para coincidir com a cobrança, portanto, os créditos por produto podem não somar exatamente a creditsUsed após o arredondamento.

requests
object

Contagens de solicitações para o ciclo de cobrança atual, apenas para produtos medidos por solicitação. Os produtos do LaserStream medidos por largura de banda (laserstreamGrpc, laserstreamWebsocket) não aparecem aqui — veja dataTransfer.

dataTransfer
object

Bytes transferidos para o ciclo de cobrança atual, apenas para os produtos medidos por largura de banda LaserStream. Esses produtos são cobrados por dados transferidos, não por contagem de solicitações, portanto, aparecem aqui e em credits, mas nunca em requests.