Skip to content

Feature flags nativas ​

Feature flags permite activar o desactivar una capacidad de una app sin publicar una nueva versión. Cada flag es booleana y queda aislada por empresa, aplicación DSL y entorno (development, staging o production). Solo las aplicaciones DSL propias de la empresa activa son válidas.

La administración requiere una sesión de usuario con rol OWNER o ADMIN. El backend vuelve a comprobar la membresía vigente en cada petición y deriva la empresa desde el contexto autenticado. No se acepta un companyId enviado por el cliente.

Obtener el identificador de evaluación ​

Cada combinación de app y entorno tiene un identificador público estable. Un OWNER o ADMIN lo obtiene o crea con:

http
POST /feature-flags/clients
Authorization: Bearer <token>
Content-Type: application/json

{
  "applicationId": "<uuid-de-app-dsl-tenant>",
  "environment": "development"
}

La respuesta 200 contiene publicClientId, applicationId y environment. El ID puede incluirse en la configuración de la app cliente para evaluar las flags de ese scope. No es un secreto y no da acceso administrativo.

Administrar flags ​

http
POST /feature-flags
Authorization: Bearer <token>
Content-Type: application/json

{
  "applicationId": "<uuid-de-app-dsl-tenant>",
  "environment": "development",
  "key": "new_dashboard",
  "name": "New dashboard",
  "enabled": false
}

La creación responde 201 y devuelve el ID de la flag.

  • key es única dentro de la empresa, app y entorno; admite letras, números, punto, guion y guion bajo, y debe comenzar con una letra.
  • Si se omite enabled, se guarda como false.
  • GET /feature-flags?applicationId=<uuid>&environment=development lista el scope.
  • GET /feature-flags/:id lee una flag; PATCH /feature-flags/:id modifica key, name o enabled; DELETE /feature-flags/:id la elimina y devuelve 204.
  • Una flag de otra empresa no se revela y responde 404.

Evaluación pública ​

http
GET /feature-flags/public/<publicClientId>/evaluate

La ruta no requiere sesión y no acepta companyId, applicationId ni environment. El servidor resuelve el scope desde el identificador guardado y devuelve únicamente las claves configuradas y sus valores booleanos:

json
{
  "flags": {
    "new_dashboard": false
  }
}

Las claves que no existen no aparecen; el consumidor puede aplicar su valor predeterminado. El SDK Browser integra la evaluación con OpenFeature y debe degradar a esos valores predeterminados si el servicio no está disponible.

Límites de seguridad y alcance ​

Una flag controla presentación o comportamiento de la interfaz. No reemplaza autorización, permisos, roles ni entitlements del backend: cada operación protegida debe volver a validar esas reglas en el servidor. La primera versión no incluye targeting por usuario, segmentos, rollout porcentual, variantes ni experimentos.