Won · usage

Ce que cette clé a dépensé, et ce qu’il reste

usage répond à « puis-je continuer ? ». Il renvoie le coût cumulé de cette clé, celui de son espace de travail sur une période, ce qu’a coûté chaque magasin durant cette période, et le solde prépayé qui conditionne l’appel suivant.

Compteurs

Un seul appel. days fixe la période des chiffres d’espace de travail et de magasin ; le chiffre de la clé est cumulé et ne bouge pas avec.

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"
ChampSignification
keyCette clé seule — jamais la liste des autres clés du compte. since vaut toujours "lifetime".
workspaceL’espace de travail auquel appartient cette clé, sur la période demandée.
storesDépense par magasin sur la période, du plus élevé au plus faible, 50 lignes au maximum. other est le poste de débordement dès qu’un compte mesure plus de 200 magasins distincts dans une journée, pas un vrai magasin.
balance_centsSolde prépayé restant sur le compte. Négatif signifie à découvert.
expiring_soon_centsSur ce qu’il reste, la part qui expire sous 90 jours.
daysPériode des chiffres d’espace de travail et de magasin. 1–365, 7 par défaut. Hors plage, la valeur est ramenée plutôt que refusée.

Gratuit, comme tout appel Won : pas de coût en jetons, pas de frais par requête, et il contourne le contrôle de solde — un compte à zéro doit pouvoir en connaître la raison. Dix par minute sur ce point d’entrée, et 300 par heure partagées entre tous les appels Won du compte.