Won · usage

Cuánto ha gastado esta clave y cuánto queda

usage responde a «¿puedo seguir?». Devuelve el coste acumulado de esta clave, el de su espacio de trabajo en una ventana, lo que costó cada almacén dentro de esa ventana y el saldo prepago que condiciona la siguiente llamada.

Recuentos

Una llamada. days fija la ventana de las cifras de espacio de trabajo y almacén; la cifra de la clave es acumulada y no cambia con ella.

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"
CampoQué significa
keySolo esta clave: nunca un listado de las otras claves de la cuenta. since siempre es "lifetime".
workspaceEl espacio de trabajo al que pertenece esta clave, durante la ventana solicitada.
storesGasto por almacén en la ventana, de mayor a menor, hasta 50 filas. other es el cajón de desbordamiento cuando una cuenta mide más de 200 almacenes distintos en un día, no un almacén real.
balance_centsSaldo prepago que queda en la cuenta. Negativo significa en descubierto.
expiring_soon_centsDe lo que queda, cuánto caduca en 90 días.
daysVentana de las cifras de espacio de trabajo y almacén. 1–365, por defecto 7. Fuera de rango se recorta en vez de rechazarse.

Gratis, como toda llamada Won: sin cargo por tokens, sin tarifa por petición y omite la comprobación de saldo — una cuenta a cero debe poder averiguar por qué. Diez por minuto en este endpoint y 300 por hora compartidas entre todas las llamadas Won de la cuenta.