Central de AjudaSolicitar SuporteStatus dos SistemasIntegrações Nativas

Monitoração e Health Check

Verificação de disponibilidade e funcionamento dos serviços

A Fidelimax disponibiliza mecanismos oficiais para acompanhamento da disponibilidade dos serviços, incluindo uma página de status pública e um endpoint específico para verificações automatizadas.

O objetivo deste documento é esclarecer como esses recursos funcionam, quando utilizá-los e como evitar bloqueios causados por uso inadequado.

Página oficial de status

Antes de implementar qualquer mecanismo próprio de monitoramento, recomendamos que os integradores utilizem exclusivamente a página de status oficial da Fidelimax:

👉 https://status.fidelimax.com.br/

Nessa página é possível acompanhar:

  • Disponibilidade em tempo real dos serviços

  • Histórico de incidentes e manutenção

  • Latência e desempenho dos principais componentes

  • Alertas públicos sobre ocorrências em andamento

Para a maioria das integrações, não é necessário criar monitoramento adicional, pois nossa página já fornece todos os indicadores essenciais de estabilidade e funcionamento.

Endpoint de Health Check

Caso ainda assim seja necessário implementar um monitoramento interno, disponibilizamos um endpoint específico para verificação simples de disponibilidade:

/api/status-check

Esse endpoint retorna uma resposta rápida que indica apenas se a API está operacional. Ele pode ser integrado a ferramentas como Zabbix, Pingdom, Grafana, UptimeRobot, entre outros.

Propósito do endpoint

  • Validar se o serviço está respondendo

  • Automatizar alertas internos

  • Alimentar sistemas de observabilidade

  • Auxiliar no funcionamento de circuit breakers ou fallback

Este endpoint não substitui validações funcionais completas e não deve ser usado para testar lógica de negócio.

Atenção importante sobre Rate Limit

Mesmo para verificações de Health Check, os limites de uso da API devem ser rigorosamente respeitados.

Se o sistema de monitoramento realizar consultas em intervalos muito curtos, poderá acionar os mecanismos automáticos de proteção e receber respostas:

  • 429 (Too Many Requests)

  • 403 (Forbidden)

Isso pode gerar a falsa impressão de downtime, quando na verdade o que ocorreu foi apenas um bloqueio temporário devido à frequência excessiva das verificações.

Consulte sempre a documentação de limites de requisição da API: 👉 Rate Limit da API aqui

Recomendações práticas

  • Utilize intervalos compatíveis com o seu plano contratado

  • Evite verificações por segundo — prefira janelas maiores

  • Configure retries inteligentes e limitados, nunca loops contínuos

  • Não utilize o endpoint como “ping” de alta frequência

Considerações sobre segurança

Por motivos de segurança, requisições ICMP (ping) para os servidores da Fidelimax são bloqueadas. Portanto, verificações de disponibilidade devem sempre ocorrer via HTTP utilizando o endpoint acima ou por meio da página oficial de status.

Suporte técnico

Se o endpoint de Health Check não estiver respondendo conforme o esperado, ou se sua ferramenta de monitoramento exigir um comportamento específico, entre em contato com o suporte oficial:

👉 https://www.fidelimax.com.br/ajuda/

A equipe poderá orientar sobre configurações adequadas de monitoramento e ajudar a ajustar o consumo dentro das políticas de tráfego da API.

PreviousRate Limit da API

Last updated

Was this helpful?