Endpoints / Configuración
Obtener configuración por clave
Obtiene una configuración específica por su clave, dentro de una empresa indicada, desde administración central.
/configs/:configKeyCaso de Uso
Se usa cuando un administrador necesita consultar el valor de una clave de configuración puntual para una empresa específica. Al usarlo, el usuario obtiene los datos completos de la configuración, incluyendo su identificador único, empresa, clave y valor.
Autenticación
Requiere token JWT en el header `Authorization: Bearer <token>`. Solo permite acceso a usuarios con rol administrador. La empresa del usuario autenticado debe estar activa y ser empresa padre.
Parámetros de ruta
configKeystringobligatorioClave de configuración.
Query params
companyIdstringobligatorioIdentificador de la empresa donde se buscará la clave.
Body
No aplica.
Reglas de negocio
Solo un usuario con rol administrador puede consultar configuraciones.
La empresa del usuario autenticado debe ser empresa padre.
La empresa del usuario autenticado debe estar activa.
El usuario autenticado debe estar activo.
configKey y companyId son obligatorios.
La búsqueda se realiza por la combinación de companyId y configKey.
Errores esperados
No se envió un token JWT válido o el token no contiene información válida del usuario.
No se envió el parámetro configKey en la ruta.
No se envió el query param companyId.
La empresa asociada al usuario autenticado no fue encontrada.
La empresa asociada al usuario autenticado está inactiva.
El usuario autenticado no fue encontrado dentro de su empresa.
El usuario autenticado no pertenece a la empresa indicada por su sesión.
El usuario autenticado no tiene el rol requerido para consultar configuraciones.
El usuario autenticado está inactivo y no puede usar el sistema.
La empresa del usuario autenticado no es empresa padre.
No existe una configuración con la combinación de companyId y configKey indicada.
Notas de uso
Este endpoint no recibe body.
companyId se envía como query param en la URL.
La búsqueda es exacta por la combinación de empresa y clave; no se realizan búsquedas parciales.