Saltar al contenido
API v1 · https://bentho.org/api
GET/api/mod/ventas/{espacio}/consumo

Lo que gastó Ventas, en créditos

Los créditos que gastó el agente de ventas en este espacio. Para el saldo de la cuenta entera, mira la bolsa de créditos.

  • PERMISOlee (vale cualquier clave)
  • CRÉDITOSno gasta
  • AUTENTICACIÓNBearer bth_…

PARÁMETROS

CAMPOTIPOREQUERIDOQUÉ ES
espaciostringSÍEl id del espacio (sale en GET /api/companies). Tiene que tener el módulo Ventas.
diasint, querynoLos últimos N días, de 1 a 400. Sin él, desde el principio.

RESPUESTA 200

CAMPOTIPOQUÉ ES
modulo · espaciostring"ventas" y tu espacio.
diasinteger | nullLa ventana que pediste. null: todo.
desde · hastastring | nullEl primer y el último día con gasto, YYYY-MM-DD.
total.creditosstringDecimal como texto, 4 decimales: "12.3456".
total.solicitudesintegerCuántas operaciones sumaron ese gasto. Un mensaje puede contar varias.
actualizadointegerCuándo se calculó, en segundos desde 1970.

ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}

STATUSCUÁNDODETAIL LITERAL
403El espacio no tiene el módulo Ventasmódulo no habilitado para este espacio.
422dias es 0, negativo o no es un entero—

Y los de cualquier ruta —clave inválida, cuenta no al día, IP, límites—, en Errores, límites y créditos.

CONVIENE SABER

  • creditos es texto, no número, para no perder precisión.