GET
/api/companiesLos espacios a los que llega tu clave
Tus espacios, con su id y sus módulos activos. Suele ser la primera llamada: el id es el {espacio} de las demás rutas, y modules te dice qué módulos responden en cada uno.
- PERMISOlee (vale cualquier clave)
- CRÉDITOSno gasta
- AUTENTICACIÓNBearer bth_…
RESPUESTA 200
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| companies | array | Uno por espacio al que llega la clave. [] si no llega a ninguno. |
| companies[].id | string | El id del espacio: el {espacio} de las demás rutas. |
| companies[].name | string | El nombre del espacio. |
| companies[].sector | string | General, Salud, Legal, Financiero, Educación… |
| companies[].modules | string[] | Los módulos activos. rag-chat y documents vienen con todo espacio; api es Bentho API. Vacía si la prueba venció o el plan se canceló. |
| companies[].trial | object | null | La prueba gratuita: status (pending, active, expired o converted, ya de pago), started_at y ends_at. null = sin prueba. |
| companies[].branding | object | null | Los colores del espacio: palette, accent, accent2, accentInk… null = sin color propio. |
ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}
| STATUS | CUÁNDO | DETAIL LITERAL |
|---|---|---|
| 401 | Clave inexistente, mal formada o revocada | Credencial de servicio inválida o revocada. |
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
- Una clave creada sin espacios llega a todos los de su dueño en cada petición, también a los que reciba después: esta lista cambia con ellos.
- En un espacio sin un módulo, sus rutas (
/api/mod/{modulo}/{espacio}/…) responden 403. Qué más puedes activar, en limite.