Skip to main content
GET
Obtener el uso del proyecto

Descripción general

Devuelve una vista completa del consumo de créditos de un proyecto durante el ciclo de créditos actual, incluidos los créditos restantes, los detalles del plan de suscripción y un desglose de las solicitudes por tipo de servicio (RPC, DAS, gRPC, WebSocket, etc.). Todas las cifras de créditos corresponden al creditCycle: el período durante el cual los créditos se acumulan y se restablecen, derivado del ancla de facturación de la suscripción. Todos los proyectos tienen uno, incluidos los planes gratuitos. El subscriptionDetails.billingCycle es el período de facturación; es informativo y tiene el valor null en los planes gratuitos, que nunca se facturan.

Parámetros de la solicitud

string
requerido
El ID del proyecto cuyo uso quieres obtener. Debe coincidir con el proyecto asociado a la clave de API utilizada para la autenticación.

Campos de la respuesta

number
Créditos restantes en el ciclo de créditos actual. Se calculan restando los créditos normales consumidos del límite de créditos del plan, con un mínimo de cero.
number
Total de créditos consumidos durante el ciclo de créditos actual, incluidos los créditos normales y prepagados.
number
Créditos prepagados que aún están disponibles.
number
Créditos prepagados consumidos durante el ciclo de créditos actual.
object
El período al que corresponden todas las cifras de créditos de esta respuesta, durante el cual los créditos se acumulan y se restablecen, derivado del ancla de facturación de la suscripción. Siempre está presente en todos los planes, incluidos los gratuitos.
string
Fecha de inicio del ciclo de créditos en formato YYYY-MM-DD (UTC).
string
Fecha de finalización del ciclo de créditos en formato YYYY-MM-DD (UTC).
object
Información sobre el plan de suscripción y el ciclo de facturación.
object | null
Fechas de inicio y finalización del ciclo de facturación actual. Solo tiene fines informativos: tiene el valor null en los planes gratuitos, que nunca se facturan. En los planes de pago, normalmente coincide con creditCycle.
string
Fecha de inicio del ciclo de facturación en formato YYYY-MM-DD.
string
Fecha de finalización del ciclo de facturación en formato YYYY-MM-DD.
number
Asignación total de créditos para el ciclo de créditos según tu plan.
string
El nombre del plan de suscripción (por ejemplo, "business", "professional").
object
Consumo de créditos por producto durante el ciclo de créditos actual, expresado en créditos enteros. Incluye todos los productos. Los valores sin procesar se acumulan y se redondean una sola vez al final para que coincidan con la facturación, por lo que, después del redondeo, es posible que la suma de los créditos por producto no coincida exactamente con creditsUsed.
number
Créditos consumidos por el RPC estándar de Solana.
number
Créditos consumidos por la API mejorada (por ejemplo, transacciones analizadas y metadatos de tokens).
number
Créditos consumidos por la API de billetera.
number
Créditos consumidos por la API de DAS (estándar de activos digitales).
number
Créditos consumidos por los webhooks.
number
Créditos consumidos por LaserStream gRPC (medidos por ancho de banda).
number
Créditos consumidos por LaserStream WebSocket (medidos por ancho de banda).
number
Créditos consumidos por Preconfirmations.
number
Créditos consumidos por el almacenamiento de archivos históricos.
number
Créditos consumidos por Photon (compresión ZK).
number
Créditos consumidos por el uso sin categorizar.
object
Número de solicitudes durante el ciclo de créditos actual, solo para los productos medidos por solicitudes. Los productos LaserStream medidos por ancho de banda (laserstreamGrpc, laserstreamWebsocket) no aparecen aquí; consulta dataTransfer. Campos: rpc, enhancedApi, walletApi, das, webhooks, preConfirmations, archival, photon, other.
object
Bytes transferidos durante el ciclo de créditos actual, solo para los productos LaserStream medidos por ancho de banda. Estos productos se facturan según los datos transferidos, no según el número de solicitudes, por lo que aparecen aquí y en credits, pero nunca en requests. Campos: laserstreamGrpc, laserstreamWebsocket.

Parámetros de la solicitud

string
requerido
El ID del proyecto cuyo uso quieres obtener. Debe coincidir con el proyecto asociado a la clave de API.

Autorizaciones

api-key
string
query
requerido

Clave de API enviada como parámetro de consulta.

Parámetros de ruta

id
string<uuid>
requerido

El ID del proyecto cuyo uso quieres obtener. Debe coincidir con el proyecto asociado a la clave de API.

Ejemplo:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

Respuesta

El uso del proyecto se obtuvo correctamente.

creditsRemaining
number

Cantidad de créditos restantes en el ciclo de créditos actual. Se calcula como creditsLimit - regularCreditsUsed, con un mínimo de 0.

Ejemplo:

487500

creditsUsed
number

Total de créditos consumidos en el ciclo de créditos actual, incluidos los créditos normales y prepagados.

Ejemplo:

12500

prepaidCreditsRemaining
number

Cantidad de créditos prepagados restantes.

Ejemplo:

50000

prepaidCreditsUsed
number

Cantidad de créditos prepagados consumidos en el ciclo de créditos actual.

Ejemplo:

0

creditCycle
object

El período al que se limitan todas las cifras de créditos de esta respuesta, es decir, el período durante el cual se acumulan y restablecen los créditos, derivado de la fecha de referencia de facturación de la suscripción. Siempre está presente en todos los planes, incluidos los planes gratuitos que nunca se facturan.

subscriptionDetails
object

Detalles sobre el plan de suscripción del proyecto y su ciclo de facturación.

credits
object

Consumo de créditos por producto durante el ciclo de créditos actual, expresado en créditos enteros. Incluye todos los productos. Los valores sin procesar se acumulan y se redondean una sola vez al final para coincidir con la facturación, por lo que la suma de los créditos por producto puede no ser exactamente igual a creditsUsed después del redondeo.

requests
object

Cantidad de solicitudes durante el ciclo de créditos actual, solo para productos medidos por solicitud. Los productos LaserStream medidos por ancho de banda (laserstreamGrpc, laserstreamWebsocket) no aparecen aquí; consulta dataTransfer.

dataTransfer
object

Bytes transferidos durante el ciclo de créditos actual, solo para los productos LaserStream medidos por ancho de banda. Estos productos se facturan según los datos transferidos, no según la cantidad de solicitudes, por lo que aparecen aquí y en credits, pero nunca en requests.