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| Champ | Signification |
|---|---|
| key | Cette clé seule — jamais la liste des autres clés du compte. since vaut toujours "lifetime". |
| workspace | L’espace de travail auquel appartient cette clé, sur la période demandée. |
| stores | Dé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_cents | Solde prépayé restant sur le compte. Négatif signifie à découvert. |
| expiring_soon_cents | Sur ce qu’il reste, la part qui expire sous 90 jours. |
| days | Pé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.