GET
/api/mod/comprension/{espacio}/consumoLo que ha gastado Comprensión
Los créditos que gastó Comprensión en el espacio y cuántas veces se llamó, en los días que pidas.
- 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 Comprensión. |
| dias | int, query | no | Los últimos N días, hoy incluido: de 1 a 400 (más de 400 cuenta como 400). Sin él, todo lo guardado. |
RESPUESTA 200
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| modulo | "comprension" | El módulo. |
| espacio | string | El espacio. |
| dias | int | null | La ventana medida. null si no pediste días. |
| desde · hasta | string | null | El primer y el último día con uso, AAAA-MM-DD. null si no hubo. |
| actualizado | integer | Cuándo se midió, en segundos desde 1970. |
| total.creditos | string | Los créditos gastados. Decimal como texto, 4 decimales: "3.2150". |
| total.solicitudes | integer | Cuántos mensajes interpretó. |
ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}
| STATUS | CUÁNDO | DETAIL LITERAL |
|---|---|---|
| 403 | El espacio no tiene el módulo Comprensión | módulo no habilitado para este espacio. |
| 422 | dias no es un entero, o es menor que 1 (detail es una lista) | — |
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
- Es lo de este módulo. Lo de toda tu cuenta, con lo que queda, en la bolsa de créditos.
creditoses texto, no número: conviértelo con un decimal de verdad (Decimalen Python).