Zum Hauptinhalt springen
GET
Projektnutzung abrufen

Übersicht

Gibt einen vollständigen Überblick über den Credit-Verbrauch eines Projekts im aktuellen Credit-Zyklus zurück. Dazu gehören die verbleibenden Credits, Details zum Abonnementtarif und eine Aufschlüsselung der requests nach Diensttyp (RPC, DAS, gRPC, WebSocket usw.). Alle Credit-Angaben beziehen sich auf creditCycle – den Zeitraum, in dem Credits anfallen und zurückgesetzt werden. Er wird aus dem Abrechnungsstichtag des Abonnements abgeleitet. Jedes Projekt hat einen solchen Zeitraum, auch bei kostenlosen Tarifen. subscriptionDetails.billingCycle ist der Rechnungszeitraum. Er dient nur zur Information und ist bei kostenlosen Tarifen null, da für diese nie Rechnungen ausgestellt werden.

Request-Parameter

string
erforderlich
Die Projekt-ID, für die du die Nutzung abrufen möchtest. Sie muss mit dem Projekt übereinstimmen, das dem zur Authentifizierung verwendeten API key zugeordnet ist.

Response-Felder

number
Verbleibende Credits im aktuellen Credit-Zyklus. Berechnet als Credit-Limit des Tarifs abzüglich der verbrauchten regulären Credits, mindestens jedoch null.
number
Gesamtzahl der im aktuellen Credit-Zyklus verbrauchten Credits, einschließlich regulärer und vorausbezahlter Credits.
number
Noch verfügbare vorausbezahlte Credits.
number
Im aktuellen Credit-Zyklus verbrauchte vorausbezahlte Credits.
object
Der Zeitraum, auf den sich alle Credit-Angaben in dieser response beziehen. In diesem Zeitraum fallen Credits an und werden zurückgesetzt. Er wird aus dem Abrechnungsstichtag des Abonnements abgeleitet. Dieses Feld ist für jeden Tarif immer vorhanden, auch für kostenlose Tarife.
string
Startdatum des Credit-Zyklus im Format YYYY-MM-DD (UTC).
string
Enddatum des Credit-Zyklus im Format YYYY-MM-DD (UTC).
object
Informationen zum Abonnementtarif und Rechnungszyklus.
object | null
Start- und Enddatum des aktuellen Rechnungszyklus. Dient nur zur Information – bei kostenlosen Tarifen ist der Wert null, da für diese nie Rechnungen ausgestellt werden. Bei kostenpflichtigen Tarifen entspricht dieser Zeitraum normalerweise creditCycle.
string
Startdatum des Rechnungszyklus im Format YYYY-MM-DD.
string
Enddatum des Rechnungszyklus im Format YYYY-MM-DD.
number
Gesamtzahl der laut deinem Tarif verfügbaren Credits für den Credit-Zyklus.
string
Der Name des Abonnementtarifs (z. B. "business", "professional").
object
Credit-Verbrauch pro Produkt für den aktuellen Credit-Zyklus, angegeben in ganzen Credits. Deckt alle Produkte ab. Die Rohwerte werden fortlaufend addiert und erst am Ende gerundet, damit sie mit der Abrechnung übereinstimmen. Deshalb entspricht die Summe der Credits pro Produkt nach dem Runden möglicherweise nicht exakt creditsUsed.
number
Durch Standard-Solana-RPC verbrauchte Credits.
number
Durch die Enhanced API verbrauchte Credits (z. B. geparste Transaktionen, Token-Metadaten).
number
Durch die Wallet API verbrauchte Credits.
number
Durch die DAS (Digital Asset Standard) API verbrauchte Credits.
number
Durch Webhooks verbrauchte Credits.
number
Durch LaserStream gRPC verbrauchte Credits (nach Bandbreite gemessen).
number
Durch LaserStream WebSocket verbrauchte Credits (nach Bandbreite gemessen).
number
Durch Preconfirmations verbrauchte Credits.
number
Durch Archivierung verbrauchte Credits.
number
Durch Photon (ZK-Komprimierung) verbrauchte Credits.
number
Durch nicht kategorisierte Nutzung verbrauchte Credits.
object
Anzahl der requests im aktuellen Credit-Zyklus, ausschließlich für Produkte, deren Nutzung anhand von requests gemessen wird. Die nach Bandbreite gemessenen LaserStream-Produkte (laserstreamGrpc, laserstreamWebsocket) erscheinen hier nicht – siehe dataTransfer. Felder: rpc, enhancedApi, walletApi, das, webhooks, preConfirmations, archival, photon, other.
object
Im aktuellen Credit-Zyklus übertragene Bytes, ausschließlich für die nach Bandbreite gemessenen LaserStream-Produkte. Diese Produkte werden nach übertragener Datenmenge und nicht nach Anzahl der requests abgerechnet. Deshalb erscheinen sie hier und in credits, aber nie in requests. Felder: laserstreamGrpc, laserstreamWebsocket.

Request-Parameter

string
erforderlich
Die Projekt-ID, für die du die Nutzung abrufen möchtest. Sie muss mit dem Projekt übereinstimmen, das dem API key zugeordnet ist.

Autorisierungen

api-key
string
query
erforderlich

API key, der als Abfrageparameter übergeben wird.

Pfadparameter

id
string<uuid>
erforderlich

Die Projekt-ID, deren Nutzung abgerufen werden soll. Sie muss mit dem Projekt übereinstimmen, das dem API key zugeordnet ist.

Beispiel:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

Antwort

Projektnutzung erfolgreich abgerufen.

creditsRemaining
number

Anzahl der im aktuellen Guthabenzyklus verbleibenden Guthabenpunkte. Berechnet als creditsLimit - regularCreditsUsed, mindestens jedoch 0.

Beispiel:

487500

creditsUsed
number

Gesamtzahl der im aktuellen Guthabenzyklus verbrauchten Guthabenpunkte, einschließlich regulärer und vorausbezahlter Guthabenpunkte.

Beispiel:

12500

prepaidCreditsRemaining
number

Anzahl der verbleibenden vorausbezahlten Guthabenpunkte.

Beispiel:

50000

prepaidCreditsUsed
number

Anzahl der im aktuellen Guthabenzyklus verbrauchten vorausbezahlten Guthabenpunkte.

Beispiel:

0

creditCycle
object

Der Zeitraum, auf den sich alle Guthabenwerte in dieser response beziehen. In diesem Zeitraum sammeln sich Guthabenpunkte an und werden zurückgesetzt. Er wird aus dem Abrechnungsstichtag des Abonnements abgeleitet. Er ist für jeden Tarif immer vorhanden, auch für kostenlose Tarife, die nie abgerechnet werden.

subscriptionDetails
object

Details zum Abonnementtarif und Abrechnungszyklus des Projekts.

credits
object

Guthabenverbrauch pro Produkt für den aktuellen Guthabenzyklus, angegeben in ganzen Guthabenpunkten. Deckt alle Produkte ab. Die Werte werden ungerundet summiert und erst am Ende gerundet, damit sie mit der Abrechnung übereinstimmen. Daher ergibt die Summe der Guthabenpunkte pro Produkt nach der Rundung möglicherweise nicht genau creditsUsed.

requests
object

Anzahl der requests im aktuellen Guthabenzyklus, ausschließlich für Produkte, deren Nutzung anhand von requests gemessen wird. Die anhand der Bandbreite gemessenen LaserStream-Produkte (laserstreamGrpc, laserstreamWebsocket) erscheinen hier nicht. Siehe dataTransfer.

dataTransfer
object

Im aktuellen Guthabenzyklus übertragene Bytes, ausschließlich für die anhand der Bandbreite gemessenen LaserStream-Produkte. Diese Produkte werden nach der übertragenen Datenmenge und nicht nach der Anzahl der requests abgerechnet. Daher erscheinen sie hier und unter credits, aber nie unter requests.