Saltar al contenido
API v1 · https://bentho.org/api
GET/api/companies/{espacio}/api-config

Lee los límites, la cuota y las IPs del espacio

Cómo está la API del espacio, cuánto se ha usado hoy y qué claves llegan a él, en una sola lectura.

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

Para cambiarla: PATCH api-config.

PARÁMETROS

CAMPOTIPOREQUERIDOQUÉ ES
espaciostringSÍEl id del espacio (sale en GET /api/companies).

RESPUESTA 200

CAMPOTIPOQUÉ ES
configobjectactiva, solicitudes_por_segundo, rafaga, cuota_diaria e ips_permitidas, con los valores por defecto en lo que nunca cambiaste.
techo_por_minutointEl tope fijo por clave en 60 s (120). Nada del espacio lo supera.
usoobjectHoy (UTC): fecha, solicitudes, atendidas, rechazadas y por_motivo (apagada, ip, cuota, tasa).
clavesarrayLas claves de tu usuario que llegan a este espacio, sin secreto: { id, nombre, email, espacios, permiso, creado, ultimo_uso, revocado, llamadas, por_ruta }.
contratadoboolSi el espacio tiene el módulo «Bentho API» (api).

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

STATUSCUÁNDODETAIL LITERAL
403La API del espacio está apagada: una clave ya no puede leerlaLa API de este espacio está apagada.

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

  • uso suma todas las claves del espacio desde las 00:00 UTC. Las rechazadas por IP o por API apagada no gastan cuota.
  • Las cifras de uso sirven para seguir el tráfico, no para facturar: pueden volver a cero si el servicio se reinicia. Lo que gastas está en la bolsa.
  • claves incluye las revocadas (revocado: true). llamadas y por_ruta cuentan las de la clave en todos sus espacios.