# 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*](/outros/rate-limit-da-api.md)
#### 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.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.fidelimax.com.br/outros/monitoracao-e-health-check.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.