Crie sua primeira flag

Nos próximos minutos você vai criar uma conta no FortressFlag, virar uma flag de verdade e ver a mudança cair na mesma resposta da API que os seus apps vão ler. Ainda não precisa instalar SDK nenhum — só um terminal no final.

1. Cadastre-se

Vá até a página de cadastro do painel e crie a sua organização. Você vai escolher um nome, definir seu e-mail e senha, e aceitar os acordos de serviço — uma caixa de seleção, cobrindo o conjunto de documentos linkado logo ao lado.

É esse o formulário inteiro. Seu teste gratuito começa na hora, inclui 1.000 dispositivos ativos mensais e nunca expira por tempo — avalie no seu ritmo.

2. Conheça o mundo de demonstração

Você chega logado como Owner da organização, e já tem algo para olhar: um projeto Example com dois ambientes — dev e production — e três flags booleanas em estados verossímeis:

• new-checkout — desligada em todo lugar, esperando o seu rollout
• dark-mode — ligada em dev, desligada em production
• beta-banner — ligada nos dois

Esse é o seu sandbox. Tudo o que você fizer no resto desta página acontece no ambiente dev, onde você pode mudar qualquer coisa à vontade.

3. Ligue uma flag

Abra o projeto Example, encontre new-checkout e ligue-a em dev. Essa é uma mudança de verdade: está no ar para todo dispositivo que lê esse ambiente, está no seu registro de auditoria, e você vai vê-la pela API daqui a pouco.

(Tente a mesma coisa em production e vai notar que o painel trata isso de outro jeito — ambientes de classe de produção recebem um visual mais chamativo e regras mais rígidas. É papéis e segurança em ação.)

4. Crie uma chave de SDK

Para ler flags do jeito que um app lê, você precisa de uma chave de cliente. No projeto Example, abra Chaves de SDK e crie uma para o ambiente dev.

A chave completa — ela começa com ffc_dev_ — é mostrada uma vez, agora. Copie-a. Depois desta tela, a lista mostra só o suficiente para identificá-la. (Perdeu? Crie outra e revogue a primeira — chaves são baratas, e revogar é instantâneo.)

5. Leia como um dispositivo leria

Peça à API de cliente as flags deste dispositivo — a mesma requisição que todo SDK faz. Coloque a chave que você acabou de copiar em uma variável, e então:

export FF_SDK_KEY="(a chave ffc_dev_ que você acabou de criar)"

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

(A resposta embrulha os dados em um payload codificado — os três últimos estágios do pipe o desembrulham. O cabeçalho X-FF-Device carrega uma identidade de dispositivo; os SDKs geram a própria, e para um experimento no terminal qualquer uma bem formada serve.)

Você recebe de volta exatamente o que um dispositivo em dev recebe:

{
  "v": 1,
  "tenant": "…o id da sua organização…",
  "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
  }
}

Lá está new-checkout: true — o seu toggle, servido. Desligue-a de novo no painel, rode o curl outra vez e veja a resposta acompanhar. É isso — você fez a sua primeira mudança de flag e a leu do data plane.

Para onde ir agora

• Coloque em um app: o quickstart de iOS, Android, web ou Go — cada um lê uma flag em poucas linhas.
• Flags e tipos — o que você acabou de ligar, com precisão.
• Convide seu time — flags são melhores em companhia.