Won · usage

这个密钥花了多少，还剩多少

usage 回答“我还能继续吗”。它返回这个密钥自身的累计费用、所属工作区在窗口期内的费用、该窗口内每个存储的费用，以及决定下一次调用的预付余额。

计数

一个调用。days 决定工作区和存储数字的窗口期；密钥自身的数字是累计值，不随它变化。

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"
字段含义
key只看这个密钥，不会列出账户里的其他密钥。since 始终是 "lifetime"。
workspace这个密钥所属工作区在所请求窗口期内的数值。
stores窗口期内各存储的费用，按用量从高到低，最多 50 行。other 是一天内计量存储超过 200 个时的溢出桶，并非真实存储。
balance_cents账户剩余的预付余额。负数表示透支。
expiring_soon_cents剩余额度中，90 天内到期的部分。
days工作区和存储数字的窗口期。1–365，默认 7。超出范围会被截断而不是拒绝。

和所有 Won 调用一样免费：没有令牌费用，没有每次请求的费用，也跳过余额检查——余额为零的账户也应该能查到原因。此端点每分钟 10 次，账户下所有 Won 调用共享每小时 300 次。