# 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/**](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*](https://docs.fidelimax.com.br/outros/rate-limit-da-api) #### 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: 👉 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.