Won · usage

Was dieser Schlüssel ausgegeben hat und was bleibt

usage beantwortet „kann ich weitermachen?“. Es liefert die Gesamtkosten dieses Schlüssels, die seines Workspace über einen Zeitraum, die Kosten je Speicher in diesem Zeitraum und das Prepaid-Guthaben, das den nächsten Aufruf freigibt.

Anzahlen

Ein Aufruf. days legt den Zeitraum für die Workspace- und Speicherzahlen fest; die Zahl des Schlüssels ist eine Gesamtsumme und bewegt sich damit nicht.

u = mem.usage(days=7)
# {"window_days": 7, "key": {"requests": 26, "cost_cents": 1.19, …}, …}

if u["balance_cents"] <= 0:
    # top up before the next write
const u = await mem.usage(7);

if (u.balance_cents <= 0) {
  // top up before the next write
}
let u = mem.usage(7).await?;
let left = u["balance_cents"].as_f64().unwrap_or(0.0);
curl https://api.wontopos.com/api/v1/won/usage?days=7 \
  -H "X-API-Key: $WOS_KEY"
FeldBedeutung
keyNur dieser Schlüssel — nie eine Liste der übrigen Schlüssel des Kontos. since ist immer "lifetime".
workspaceDer Workspace dieses Schlüssels, über den angefragten Zeitraum.
storesAusgaben je Speicher im Zeitraum, absteigend, höchstens 50 Zeilen. other ist der Sammelposten, sobald ein Konto an einem Tag mehr als 200 verschiedene Speicher misst — kein echter Speicher.
balance_centsVerbleibendes Prepaid-Guthaben des Kontos. Negativ heißt überzogen.
expiring_soon_centsWie viel vom Rest innerhalb von 90 Tagen verfällt.
daysZeitraum für Workspace- und Speicherzahlen. 1–365, Standard 7. Außerhalb des Bereichs wird begrenzt statt abgelehnt.

Kostenlos wie jeder Won-Aufruf: keine Tokenkosten, keine Gebühr je Anfrage, und die Guthabenprüfung wird übersprungen — ein Konto bei null muss den Grund erfahren können. Zehn pro Minute an diesem Endpunkt, und 300 pro Stunde geteilt über alle Won-Aufrufe des Kontos.