Passa al contenuto principale

Obtener configuración general del sistema

GET 
/settings/

Devuelve la configuración general de la plataforma, incluyendo nombre de compañía, zona horaria e idioma predeterminado.

Propósito:

  • Proporcionar acceso a la configuración central del sistema
  • Permitir la gestión de parámetros globales
  • Sincronizar configuración entre diferentes servicios

Casos de uso:

  • Panel de administración del sistema
  • Configuración inicial de la plataforma
  • Sincronización de parámetros globales
  • Migración de configuraciones entre entornos

Flujo típico:

  1. El administrador accede al panel de configuración
  2. El frontend llama a este endpoint con token de administrador
  3. El servidor valida los permisos y obtiene la configuración
  4. Retorna los parámetros de configuración actuales
  5. El frontend muestra la interfaz de configuración

Consideraciones:

  • Requiere permisos de administrador (JWT con rol admin)
  • Los cambios afectan a toda la plataforma
  • La zona horaria debe ser válida (ej. "Europe/Madrid")
  • Los idiomas soportados son español (es) e inglés (en)

Ejemplo de implementación:

// Ejemplo de consumo desde frontend admin
async function loadSystemSettings() {
  try {
    const response = await fetch('/company/settings/', {
      headers: {
        'Authorization': `Bearer ${adminToken}`
      }
    });
    
    if (response.ok) {
      const settings = await response.json();
      renderSettingsForm(settings);
    } else {
      showError('No tienes permisos de administrador');
    }
  } catch (error) {
    console.error('Error loading system settings:', error);
  }
}

Responses​

Configuración general obtenida