GET
/api/mod/ventas/{espacio}/consumoLo 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
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| espacio | string | SÍ | El id del espacio (sale en GET /api/companies). Tiene que tener el módulo Ventas. |
| dias | int, query | no | Los últimos N días, de 1 a 400. Sin él, desde el principio. |
RESPUESTA 200
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| modulo · espacio | string | "ventas" y tu espacio. |
| dias | integer | null | La ventana que pediste. null: todo. |
| desde · hasta | string | null | El primer y el último día con gasto, YYYY-MM-DD. |
| total.creditos | string | Decimal como texto, 4 decimales: "12.3456". |
| total.solicitudes | integer | Cuántas operaciones sumaron ese gasto. Un mensaje puede contar varias. |
| actualizado | integer | Cuándo se calculó, en segundos desde 1970. |
ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}
| STATUS | CUÁNDO | DETAIL LITERAL |
|---|---|---|
| 403 | El espacio no tiene el módulo Ventas | módulo no habilitado para este espacio. |
| 422 | dias 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
creditoses texto, no número, para no perder precisión.