Saltar al contenido
API v1 · https://bentho.org/api
GET/api/cuentas/{cuenta}/cierres

Lo gastado en cada ciclo cerrado

Los créditos que gastó la cuenta en cada ciclo mensual ya cerrado, del más antiguo al más reciente. En el plan por uso, es lo que se factura cada mes.

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

PARÁMETROS

CAMPOTIPOREQUERIDOQUÉ ES
cuentastringSÍEl id de la cuenta. Desde un espacio: GET …/cuenta → cuenta.id.

RESPUESTA 200

CAMPOTIPOQUÉ ES
cuenta · plan_idstring · string | nullLa cuenta y su plan.
cierresarrayUn elemento por ciclo cerrado. [] si aún no se ha cerrado ninguno.
cierres[].inicio · finstringPrimer y último día del ciclo, los dos incluidos (AAAA-MM-DD).
cierres[].creditosstringLos créditos gastados. Decimal como texto, 4 decimales: "152.3071".
cierres[].espaciosstring[]Los espacios que se sumaron.
cierres[].completaboolfalse = la cifra es un suelo: se gastó al menos eso.
cierres[].modulos_mudosstring[]Los módulos que no respondieron al medir: su gasto no está en la cifra.
cierres[].llamadas_sin_reporteintLlamadas cuyo gasto no quedó medido. Más de 0 = la cifra es un suelo.
cierres[].cerrado_enstringCuándo se escribió el cierre (ISO 8601, UTC).

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

STATUSCUÁNDODETAIL LITERAL
403La cuenta no es tuyaSin acceso a esta cuenta.
404No existeCuenta no encontrada.

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

  • Cada ciclo se cierra el primer día del siguiente. Un cierre con completa: false todavía puede cambiar: Bentho lo vuelve a medir en los días siguientes al fin del ciclo.
  • Lee lo ya escrito, así que responde rápido. Para el ciclo en curso, usa la bolsa.
  • creditos es texto, no número, como en la bolsa: conviértelo con un decimal de verdad.
  • Solo se cierran las cuentas con ciclo: las que tienen ancla_ciclo o pagado_hasta (ver cuenta).