Monitoramento de API Web: Escolhendo o Protocolo Certo

O Dotcom-Monitor suporta REST, SOAP, GraphQL, gRPC, WebSockets e Webhooks. Monitores REST validam asserções JSONPath e métodos HTTP. Monitores SOAP analisam WSDL e validam XML com XPath. Monitores GraphQL lidam com queries, mutations e estruturas de dados aninhadas. Monitores gRPC decodificam respostas Protobuf. Monitores WebSocket acompanham fluxos de mensagens bidirecionais. Monitores Webhook verificam entregas e lógica de re-tentativas.

Monitores de múltiplas etapas encadeiam até 20 chamadas API em sequência. Cada etapa pode extrair dados da resposta anterior usando JSONPath ou XPath, e então passá-los para a próxima requisição como header, parâmetro de consulta ou campo do corpo. Por exemplo, a etapa 1 pode fazer um POST para /login e extrair um token JWT, a etapa 2 usa esse token no cabeçalho Authorization para um GET /cart, e a etapa 3 usa o ID do carrinho da etapa 2 para fazer um POST /checkout. Cada etapa rastreia tempo, códigos de status e payloads de resposta de forma independente.

O Dotcom-Monitor suporta OAuth 2.0 (com atualização automática de token), JWT, chaves API, Basic Auth e esquemas personalizados de cabeçalho. As credenciais são criptografadas no Cofre Seguro. Para OAuth 2.0, o monitor pode atualizar automaticamente tokens de acesso ao expirarem. Autenticação baseada em certificado (mTLS) é suportada para endpoints gRPC e HTTPS. Monitores SOAP suportam tokens de usuário WS-Security e certificados X.509.

Sim. O Dotcom-Monitor importa Coleções Postman (v2.1) e exportações do Insomnia com um clique. O processo de importação converte requisições, cabeçalhos, autenticação e variáveis de ambiente em monitores Dotcom-Monitor. Fluxos de trabalho em múltiplas etapas são preservados, e asserções JSONPath podem ser adicionadas após a importação. Variáveis como {{baseUrl}} e {{authToken}} são mapeadas automaticamente para variáveis Dotcom-Monitor.

Use asserções JSONPath para REST e GraphQL (ex.: $.status == “success” ou $.items.length > 0). Use XPath para respostas XML SOAP (ex.: //OrderStatus/text() = “Confirmed”). Você também pode validar códigos de status HTTP (200, 201, 204, 400, 500), cabeçalhos de resposta (Content-Type, Cache-Control) e limites de tempo de resposta (ex.: etapa 1 < 500ms, etapa 3 < 2000ms). Correspondência por padrão Regex está disponível para validação personalizada.

Quando um monitor falha (erro de código de status, falha na asserção, timeout ou falha na resolução DNS), o Dotcom-Monitor envia alertas para Slack, PagerDuty, Microsoft Teams, email ou webhook em até 30 segundos. O alerta inclui diagnósticos passo a passo: tempo de resolução DNS, duração do handshake SSL, tempo de resposta por etapa, payloads completos de resposta e mensagens de erro. Os monitores tentam 3 vezes antes de disparar um alerta para evitar falsos positivos.

Sim. O Agente Privado do Dotcom-Monitor executa dentro da sua rede para monitorar APIs internas, ambientes de staging e endpoints protegidos por firewall. O agente conecta-se externamente à plataforma Dotcom-Monitor (não são necessárias regras de firewall de entrada), executa monitores conforme sua programação e reporta os resultados. Agentes Privados suportam todos os protocolos (REST, SOAP, GraphQL, gRPC, WebSockets, Webhooks) e todos os métodos de autenticação.

O Dotcom-Monitor oferece uma API REST e um provider Terraform para gerenciar monitores como código. Você pode criar, atualizar ou deletar monitores a partir de pipelines CI/CD usando arquivos de configuração YAML. Dispare checagens de API sob demanda via Jenkins, GitLab CI, GitHub Actions ou CircleCI. Falhe builds se tempos de resposta API excederem limites ou asserções falharem. Exporte configurações de monitores para controle de versão e auditoria.