Skip to main content
GET
Obtenir l'utilisation du projet

Aperçu

Retourne une image complète de la consommation de crédits d’un projet pour le cycle de crédit actuel, y compris les crédits restants, les détails du plan d’abonnement, et une ventilation des demandes par type de service (RPC, DAS, gRPC, WebSocket, etc.). Tous les chiffres de crédits sont attachés à creditCycle — la fenêtre où les crédits s’accumulent et se réinitialisent, dérivée de l’ancrage de facturation de l’abonnement. Chaque projet en a un, y compris les plans gratuits. subscriptionDetails.billingCycle est la fenêtre de facturation ; elle est informative et null pour les plans gratuits, qui ne sont jamais facturés.

Paramètres de la demande

string
requis
L’ID du projet pour lequel récupérer l’utilisation. Doit correspondre au projet associé à la clé API utilisée pour l’authentification.

Champs de réponse

number
Crédits restants dans le cycle de crédit actuel. Calculé comme la limite de crédit du plan moins les crédits consommés, plafonné à zéro.
number
Total des crédits consommés dans le cycle de crédit actuel, y compris les crédits réguliers et prépayés.
number
Crédits prépayés encore disponibles.
number
Crédits prépayés consommés dans le cycle de crédit actuel.
object
La fenêtre à laquelle chaque chiffre de crédit dans cette réponse est attaché — la période où les crédits s’accumulent et se réinitialisent, dérivée de l’ancrage de facturation de l’abonnement. Toujours présent, pour chaque plan, y compris les plans gratuits.
string
Date de début du cycle de crédit au format YYYY-MM-DD (UTC).
string
Date de fin du cycle de crédit au format YYYY-MM-DD (UTC).
object
Informations sur le plan d’abonnement et le cycle de facturation.
object | null
Dates de début et de fin du cycle de facturation actuel. Informative uniquement — null pour les plans gratuits, qui ne sont jamais facturés. Pour les plans payants, cela correspond normalement à creditCycle.
string
Date de début du cycle de facturation au format YYYY-MM-DD.
string
Date de fin du cycle de facturation au format YYYY-MM-DD.
number
Limite totale de crédits pour le cycle de crédit selon votre plan.
string
Le nom du plan d’abonnement (par exemple, "business", "professional").
object
Consommation de crédits par produit pour le cycle de crédit actuel, en crédits entiers. Couvre chaque produit. Les valeurs sont accumulées brutes et arrondies une fois à la fin pour correspondre à la facturation, donc les crédits par produit peuvent ne pas s’additionner exactement à creditsUsed après arrondi.
number
Crédits consommés par le Solana RPC standard.
number
Crédits consommés par l’API améliorée (par exemple, transactions analysées, métadonnées de jeton).
number
Crédits consommés par l’API de portefeuille.
number
Crédits consommés par l’API DAS (Norme des Actifs Numériques).
number
Crédits consommés par les Webhooks.
number
Crédits consommés par LaserStream gRPC (mesurés par bande passante).
number
Crédits consommés par LaserStream WebSocket (mesurés par bande passante).
number
Crédits consommés par les Pré-confirmations.
number
Crédits consommés par l’archivage.
number
Crédits consommés par Photon (Compression par ZK).
number
Crédits consommés par des usages non catégorisés.
object
Comptes de demandes pour le cycle de crédit actuel, uniquement pour les produits mesurés par demande. Les produits LaserStream mesurés par bande passante (laserstreamGrpc, laserstreamWebsocket) n’apparaissent pas ici — voir dataTransfer. Champs : rpc, enhancedApi, walletApi, das, webhooks, preConfirmations, archival, photon, other.
object
Octets transférés pour le cycle de crédit actuel, uniquement pour les produits LaserStream mesurés par bande passante. Ces produits sont facturés par les données transférées, pas le nombre de demandes, donc ils apparaissent ici et dans credits mais jamais dans requests. Champs : laserstreamGrpc, laserstreamWebsocket.

Paramètres de la demande

string
requis
L’ID du projet pour lequel récupérer l’utilisation. Doit correspondre au projet associé à la clé API.

Autorisations

api-key
string
query
requis

Clé API passée en tant que paramètre de requête.

Paramètres de chemin

id
string<uuid>
requis

L'ID du projet pour lequel récupérer l'utilisation. Doit correspondre au projet associé à la clé API.

Exemple:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

Réponse

Utilisation du projet récupérée avec succès.

creditsRemaining
number

Nombre de crédits restants dans le cycle de crédit actuel. Calculé comme creditsLimit - regularCreditsUsed, arrondi à 0.

Exemple:

487500

creditsUsed
number

Total des crédits consommés dans le cycle de crédit actuel, y compris les crédits réguliers et prépayés.

Exemple:

12500

prepaidCreditsRemaining
number

Nombre de crédits prépayés restants.

Exemple:

50000

prepaidCreditsUsed
number

Nombre de crédits prépayés consommés dans le cycle de crédit actuel.

Exemple:

0

creditCycle
object

La période à laquelle chaque donnée de crédit dans cette réponse est limitée — la période de crédit qui s'accumule et se réinitialise, dérivée de l'ancrage de facturation de l'abonnement. Toujours présent, pour chaque plan, y compris les plans gratuits qui ne sont jamais facturés.

subscriptionDetails
object

Détails sur le plan d'abonnement du projet et le cycle de facturation.

credits
object

Consommation de crédits par produit pour le cycle de crédit actuel, en crédits entiers. Couvre chaque produit. Les valeurs sont accumulées à l'état brut et arrondies une fois à la fin pour correspondre à la facturation, de sorte que les crédits par produit peuvent ne pas s'additionner exactement à creditsUsed après l'arrondissement.

requests
object

Comptage des requêtes pour le cycle de crédit actuel, uniquement pour les produits tarifés à la requête. Les produits LaserStream mesurés par bande passante (laserstreamGrpc, laserstreamWebsocket) n'apparaissent pas ici — voir dataTransfer.

dataTransfer
object

Octets transférés pour le cycle de crédit actuel, uniquement pour les produits LaserStream mesurés par bande passante. Ces produits sont facturés par les données transférées, pas par le nombre de requêtes, ils apparaissent donc ici et dans credits mais jamais dans requests.