Ir al contenido

Crea tu primer flag

En los próximos minutos crearás una cuenta de FortressFlag, cambiarás un flag real y verás el cambio aterrizar en la misma respuesta de la API que leerán tus apps. Todavía no hace falta instalar ningún SDK — solo una terminal al final.

Ve a la página de registro del panel y crea tu organización. Elegirás un nombre, pondrás tu correo y tu contraseña, y aceptarás los acuerdos de servicio — una casilla, que cubre el conjunto de documentos enlazados justo al lado.

Ese es todo el formulario. Tu prueba empieza de inmediato, incluye 1.000 dispositivos activos mensuales y nunca caduca por tiempo — evalúa a tu ritmo.

Aterrizas con la sesión iniciada como Owner de la organización, y ya hay algo que mirar: un proyecto Example con dos entornos — dev y production — y tres flags booleanos en estados creíbles:

  • new-checkout — desactivado en todas partes, esperando su rollout
  • dark-mode — activado en dev, desactivado en production
  • beta-banner — activado en ambos

Este es tu entorno de pruebas. Todo lo que hagas en el resto de esta página ocurre en el entorno dev, donde puedes cambiar cualquier cosa libremente.

Abre el proyecto Example, busca new-checkout y actívalo en dev. Es un cambio real: está activo para cada dispositivo que lea este entorno, está en tu registro de auditoría, y lo verás desde la API en un momento.

(Prueba lo mismo en production y notarás que el panel lo trata de otra manera — los entornos de clase producción reciben un estilo más llamativo y reglas más estrictas. Eso es roles y seguridad en acción.)

Para leer flags como lo hace una app, necesitas una clave de cliente. En el proyecto Example, abre Claves SDK y emite una para el entorno dev.

La clave completa — empieza por ffc_dev_ — se muestra una vez, ahora mismo. Cópiala. Después de esta pantalla, la lista muestra solo lo suficiente para identificarla. (¿La perdiste? Emite otra y revoca la primera — las claves son baratas, y revocar es instantáneo.)

Pide a la API de cliente los flags de este dispositivo — la misma petición que hace cada SDK. Pon la clave que acabas de copiar en una variable, y después:

Terminal window
export FF_SDK_KEY="(la clave ffc_dev_ que acabas de emitir)"
curl -s "https://edge.fortressflag.com/v1/client/flags?environment=dev" \
-H "Authorization: Bearer $FF_SDK_KEY" \
-H "X-FF-Device: dev_8KqW3nR2vT7yLp0aZxQmBg" \
| jq -r .payload | tr '_-' '/+' | base64 -d | jq

(La respuesta envuelve sus datos en un payload codificado — las tres últimas etapas de la tubería lo desenvuelven. La cabecera X-FF-Device lleva una identidad de dispositivo; los SDK emiten la suya, y para un experimento en la terminal vale cualquiera bien formada.)

Recibirás exactamente lo que recibe un dispositivo en dev:

{
"v": 1,
"tenant": "…el id de tu organización…",
"environment": "dev",
"device": "dev_8KqW3nR2vT7yLp0aZxQmBg",
"issuedAt": "2026-08-23T15:00:00Z",
"expiresAt": "2026-08-23T15:30:00Z",
"flags": {
"new-checkout": true,
"dark-mode": true,
"beta-banner": true
}
}

Ahí está new-checkout: true — tu cambio, servido. Vuelve a desactivarlo en el panel, ejecuta el curl otra vez y mira cómo le sigue. Eso es todo — has hecho tu primer cambio de flag y lo has leído desde el plano de datos.

  • Mételo en una app: la guía rápida de iOS, Android, web o Go — cada una lee un flag en unas pocas líneas.
  • Flags y tipos — lo que acabas de cambiar, con precisión.
  • Invita a tu equipo — los flags son mejores en compañía.