GET
/api/cuentas/{cuenta}/bolsaTus créditos
Los créditos incluidos, gastados y restantes de la cuenta, que agrupa tus espacios. Es lo que mira Bentho para cortar con 402 cuando se agotan.
- PERMISOlee (vale cualquier clave)
- CRÉDITOSno gasta
- AUTENTICACIÓNBearer bth_…
PARÁMETROS
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| cuenta | string | SÍ | El id de la cuenta. Desde un espacio: GET /api/companies/{espacio}/cuenta → cuenta.id. |
| dias | int, query | no | Mide los últimos N días. Sin él, el ciclo en curso: la misma ventana con la que se corta. |
RESPUESTA 200
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| creditos.permitido | bool | false = bolsa agotada. |
| creditos.incluidos | int | null | Los del plan. null = sin techo. |
| creditos.gastados | string | Decimal como texto, 4 decimales: "0.3426". |
| creditos.restantes | string | null | Lo que queda del ciclo. |
| creditos.porcentaje | string | null | Fracción gastada, de 0 a 1. |
| creditos.motivo | string | ok, bolsa_agotada, sin_plan o sin_creditos_acordados. |
| dias · renueva | int · string | null | La ventana medida y el primer día del ciclo siguiente. |
ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}
| STATUS | CUÁNDO | DETAIL LITERAL |
|---|---|---|
| 403 | La cuenta no es tuya | Sin acceso a esta cuenta. |
| 404 | No existe | Cuenta no encontrada. |
| 422 | dias 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
gastadosyrestantesson texto, no números: así no pierden precisión. Conviértelos con un decimal de verdad (Decimalen Python).- Consulta a cada módulo en el momento: puede tardar más que las demás rutas.