Sua API é a espinha dorsal do seu produto. Quando ela cai — ou fica lenta — seus clientes sentem. Mas a maioria das equipes lida com quedas de forma reativa: os usuários reclamam, alguém verifica os logs, e 30 minutos depois uma resposta é publicada. Uma página de status pública inverte essa dinâmica. Ela permite que seus clientes verifiquem a saúde da API por conta própria, em tempo real, sem abrir um ticket.

Neste tutorial, você vai aprender o que faz uma boa página de status, como criar uma gratuitamente com Nurbak, e como incorporar badges de uptime diretamente na sua documentação.

O que é uma página de status e por que você precisa de uma?

Uma página de status é uma página acessível publicamente que mostra o estado atual dos endpoints da sua API. É como um dashboard ao vivo para seus clientes — sem necessidade de login.

  • Transparência gera confiança — quando os clientes podem ver os dados de uptime por conta própria, eles confiam mais no seu serviço.
  • Menos tickets de suporte — durante uma queda, a primeira coisa que os usuários fazem é perguntar "É só comigo?". Uma página de status responde isso instantaneamente, reduzindo o volume de suporte em 30-50%.
  • Comunicação de incidentes mais rápida — em vez de escrever respostas individuais, você atualiza uma única página que alcança todos os usuários afetados.
  • Vantagem competitiva — muitas APIs ainda não têm uma página de status pública. Ter uma diferencia você como um provedor sério e confiável.

DIY vs páginas de status hospedadas

Você pode construir a sua própria ou usar uma solução hospedada. A abordagem DIY dá controle total sobre o design, mas você precisa construir e manter a lógica de monitoramento, e se sua infraestrutura cair, sua página de status também cai. Uma solução hospedada como o Nurbak fica pronta em minutos, roda em infraestrutura independente e inclui monitoramento automático — sem manutenção.

Para a maioria das equipes — especialmente startups e indie hackers — uma página de status hospedada é a melhor escolha.

O que uma boa página de status deve mostrar

Uma página que só diz "Todos os sistemas operacionais" com um ponto verde é quase inútil. Aqui está o que uma boa página de status deve exibir:

  • Status por endpoint — mostre a saúde de cada endpoint individual, não apenas um agregado.
  • Linha do tempo de uptime — uma visualização de 30 dias mostrando quando cada endpoint estava ativo, degradado ou fora.
  • Porcentagem geral de uptime — um número claro (ex: 99.97%) que resume a confiabilidade em um período.
  • Horário da última verificação — um timestamp que comprova que os dados são atuais.

Como o Nurbak oferece páginas de status públicas gratuitas

Nurbak inclui uma página de status pública para cada projeto — em todos os planos, incluindo o gratuito.

Passo 1: Crie um projeto e adicione endpoints

Cadastre-se e crie um projeto. Adicione os endpoints que deseja monitorar. O Nurbak começa a executar health checks imediatamente de múltiplas regiões globais.

Passo 2: Ative a página de status pública

Nas configurações do projeto, ative a página de status pública. O Nurbak gera uma URL única e compartilhável:

https://app.nurbak.com/status/:token

Qualquer pessoa com a URL pode visualizar a página — sem necessidade de autenticação.

Passo 3: Escolha o que exibir

Você controla quais endpoints aparecem na página de status. Talvez você queira mostrar suas rotas de API públicas mas ocultar endpoints administrativos internos.

Passo 4: Compartilhe o link

Sua página de status está no ar. Os visitantes veem o status atual de cada endpoint, uma linha do tempo de 30 dias, a porcentagem geral de uptime e o horário da última verificação.

Badges de uptime incorporáveis

Além da página de status, o Nurbak fornece badges SVG de uptime incorporáveis — similares aos badges de build que você vê nos READMEs do GitHub.

Cada badge está disponível em:

https://app.nurbak.com/badge/:id.svg

O badge é codificado por cores: verde (ativo), amarelo (latência elevada), vermelho (fora). São cacheados por 5 minutos. Incorpore-os no seu README do GitHub, documentação de API ou landing page.

Página de status vs monitoramento

Um equívoco comum é pensar que uma página de status substitui o monitoramento. Não substitui — eles servem audiências diferentes. O monitoramento é para sua equipe de engenharia (métricas detalhadas, alertas no Slack/email/WhatsApp). A página de status é para seus clientes (visão simplificada, acesso público). Com o Nurbak, você tem ambos em uma única ferramenta.

Perguntas frequentes

Os clientes podem ver métricas detalhadas?

Não. A página pública mostra uma visão curada: status do endpoint, porcentagem de uptime, linha do tempo de 30 dias e horário da última verificação. Métricas detalhadas como latência P95, tempo de resolução DNS e duração do handshake TLS são visíveis apenas para os proprietários do projeto.

Com que frequência é atualizada?

A página sempre reflete o resultado do último health check. As verificações são executadas a cada 1 a 5 minutos dependendo do seu plano, de múltiplas regiões globais.

É gratuita?

Sim. Páginas de status públicas estão incluídas em todos os planos do Nurbak, incluindo o gratuito. Não há limite de visitantes nem custo adicional pelos badges incorporáveis.

Crie sua página de status grátis — sem cartão de crédito.