PATCH
/api/companies/{espacio}/api-configLímites, cuota diaria e IPs del espacio
Decide si la API del espacio está activa, cuántas peticiones por segundo acepta, su ráfaga, su cuota diaria y qué IPs pueden llamar. Se valida el resultado: lo guardado más lo que mandas.
- PERMISOescribe
- 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). |
CUERPO · JSON
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| activa | bool | no | Apaga o enciende la API del espacio. Ojo: una clave que la apaga se deja fuera a sí misma. |
| solicitudes_por_segundo | int | no | 1 – 1000. Por defecto, 2. |
| rafaga | int | no | 1 – 5000 y no menor que solicitudes_por_segundo. Por defecto, 120. |
| cuota_diaria | int | null | no | 100 – 100 000 000 peticiones al día (UTC). null = sin tope. |
| ips_permitidas | string[] | no | Hasta 100 IPs o rangos CIDR, v4 o v6. [] = cualquiera. Ver Lista de IPs. |
RESPUESTA 200
Los cinco campos, como quedaron guardados (las IPs, ya normalizadas).
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| config | object | activa, solicitudes_por_segundo, rafaga, cuota_diaria, ips_permitidas. |
GET /API/COMPANIES/{ESPACIO}/API-CONFIG DEVUELVE ADEMÁS
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| techo_por_minuto | int | El tope global por clave (120 por defecto). |
| uso | object | Del día (UTC): solicitudes, atendidas, rechazadas y por_motivo (apagada, ip, cuota, tasa). |
| claves | array | Tus claves que alcanzan este espacio, sin secreto. |
| contratado | bool | Si el espacio tiene el módulo «Bentho API». |
ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}
| STATUS | CUÁNDO | DETAIL LITERAL |
|---|---|---|
| 403 | Sin el módulo contratado | Este espacio no tiene contratado el módulo «Bentho API». |
| 403 | Clave de solo lectura | Tu cuenta es de solo lectura en este espacio. |
| 404 | El espacio no existe | Espacio no encontrado. |
| 422 | Ráfaga menor que la tasa | «rafaga» no puede ser menor que «solicitudes_por_segundo»: el cubo se vaciaría antes de rellenarse un segundo. |
| 422 | IP mal escrita | «<valor>» no es una IP ni un rango CIDR válido. |
| 422 | Más de 100 IPs | Como máximo 100 IPs o rangos. |
| 422 | Campo desconocido | Campos desconocidos: ['<campo>', …]. |
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
- Guardar reinicia los cubos del espacio, no los contadores del día.
- Estos límites se aplican solo a las claves. El Studio, con tu sesión, sigue entrando aunque apagues la API.