Nutzung
Überwachen Sie Abo-Kontingent, Einmalpaket und Credits in Echtzeit.
Der Usage-Endpunkt liefert Abonnementkontingent, Einmalpaket, Credits, Ratenlimits und API-Schlüssel-Details. Er verbraucht keine Credits.
Hinweis: Das Objekt subscription gibt das kombinierte Abonnementkontingent plus verbleibende Pakete zurück, nicht nur den Abonnement-Anteil. Das Dashboard-Panel API-Nutzung zeigt die drei Guthaben getrennt.
Dieser Endpunkt ist kostenlos. Er verbraucht niemals Credits.
Anfrage
curl "https://api.chartquery.com/v1/usage" \
-H "x-api-key: YOUR_API_KEY"Die drei Guthaben
Jeder Aufruf wird aus bis zu drei Guthaben bedient, immer in dieser Reihenfolge. Die Antwort weist jedes einzeln aus, damit Sie sehen, woher Ihre Credits stammen.
- Abonnementkontingent (
subscription): im Monatsplan enthaltene Aufrufe. Wird zu jeder Abrechnungsperiode zurückgesetzt (period,renewal_date). - Einmalpaket (
packs): einmalige API-Pakete, nie zurückgesetzt, in Kaufreihenfolge nach dem Abonnementkontingent.packs.currentist das aktuell genutzte Paket. - Credits (
credits): nur genutzt, wenn Kontingent und Pakete aufgebraucht sind. Separat abgerechnet.
remaining ist der über alle drei Guthaben noch verfügbare Gesamtbetrag, total_used der insgesamt verbrauchte. Erreicht remaining 0, liefern Aufrufe 402, bis ein Paket oder Credits hinzukommen.
Antwortfelder
| Feld | Typ | Beschreibung |
|---|---|---|
remaining | integer | Gesamt noch verfügbar über alle drei Guthaben (Abo-Kontingent + Einmalpaket + Credits) |
total_used | integer | Gesamt verbraucht über alle drei Guthaben (Paketverbrauch bleibt über Abrechnungsperioden erhalten) |
renewal_date | string | Datum der Abonnementverlängerung (ISO 8601) |
period.start | string | Beginn des aktuellen Abrechnungszeitraums |
period.end | string | Ende des aktuellen Abrechnungszeitraums |
subscription.used | integer | Verbrauchte API-Aufrufe gegen das kombinierte API-Kontingent |
subscription.total | integer | Kombiniertes API-Kontingent (Abonnement + Einmalpakete) |
subscription.remaining | integer | Verbleibendes kombiniertes API-Kontingent (Abonnement-Rest + ungenutzte Einmalpakete) |
subscription.percent_used | number | Prozentsatz des verbrauchten API-Kontingents |
credits.given | integer | Gewährte Credits (separates Saldo) |
credits.consumed | integer | Verbrauchte Credits |
credits.remaining | integer | Verbleibende Credits |
rate_limit.per_minute | integer | null | Anfragen pro Minute (null = unbegrenzt) |
rate_limit.per_second | integer | null | Anfragen pro Sekunde (null = unbegrenzt) |
account.name | string | Name des Kontos |
account.slug | string | Kontobezeichner |
api_key.alias | string | Anzeigename des API-Schlüssels |
api_key.active | boolean | Ob der Schlüssel aktuell aktiv ist |
api_key.category | string | Schlüsselkategorie (z. B. development, production) |
api_key.expires | string | null | Ablaufdatum des Schlüssels (null = läuft nie ab) |
api_key.quotas | object | Benutzerdefinierte Schlüsselkontingente: total, daily, weekly, monthly |
packs | object | null | Einmalige API-Pakete, Paket für Paket (null, wenn das Konto keines hat). Bei Konten ohne Monatsplan ist subscription.total die Summe aller Pakete |
packs.count | integer | Anzahl aktiver Pakete |
packs.exhausted_count | integer | Anzahl vollständig verbrauchter Pakete |
packs.total | integer | Von allen aktiven Paketen gewährte Credits |
packs.used | integer | Über alle Pakete verbrauchte Credits |
packs.remaining | integer | Über alle Pakete verbleibende Credits |
packs.current | object | null | Das aktuell verbrauchte Paket (Pakete werden in Kaufreihenfolge genutzt); null, wenn alle aufgebraucht sind |
packs.items[] | object[] | Jedes aktive Paket: id, title, purchased_at, total, used, remaining, percent_used, exhausted |
Beispielantwort
{
"remaining": 450,
"total_used": 1550,
"renewal_date": "2026-04-25",
"period": {
"start": "2026-03-25",
"end": "2026-04-25"
},
"subscription": {
"used": 1550,
"total": 2000,
"remaining": 450,
"percent_used": 77
},
"packs": {
"count": 2,
"exhausted_count": 1,
"all_exhausted": false,
"total": 25000000,
"used": 15200000,
"remaining": 9800000,
"percent_used": 60.8,
"current_index": 2,
"current": {
"id": "cm…",
"title": "Ultimate",
"purchased_at": "2026-02-07",
"total": 12500000,
"used": 2700000,
"remaining": 9800000,
"percent_used": 21.6,
"exhausted": false
},
"items": [
{ "id": "cm…", "title": "Ultimate", "purchased_at": "2025-11-10", "total": 12500000, "used": 12500000, "remaining": 0, "percent_used": 100, "exhausted": true },
{ "id": "cm…", "title": "Ultimate", "purchased_at": "2026-02-07", "total": 12500000, "used": 2700000, "remaining": 9800000, "percent_used": 21.6, "exhausted": false }
]
},
"credits": {
"given": 0,
"consumed": 0,
"remaining": 0,
"percent_used": 0
},
"rate_limit": {
"per_minute": null,
"per_second": null
},
"account": {
"name": "Acme Corp",
"slug": "acme-corp"
},
"api_key": {
"alias": "production",
"active": true,
"category": "production",
"expires": null,
"quotas": {
"total": null,
"daily": null,
"weekly": null,
"monthly": null
}
}
}Siehe auch: Stats für die Infrastrukturgesundheit der Plattform in der letzten Stunde. Das ist nicht Ihre Kontonutzung.