Monitoramento de API Web: Escolhendo o Protocolo Certo

O Dotcom-Monitor suporta REST, SOAP, GraphQL, gRPC, WebSockets e Webhooks. Monitores REST validam afirmações JSONPath e métodos HTTP. Monitores SOAP analisam WSDL e validam XML com XPath. Monitores GraphQL lidam com consultas, mutações e estruturas de dados aninhadas. Monitores gRPC decodificam respostas Protobuf. Monitores WebSocket acompanham fluxos de mensagens bidirecionais. Monitores Webhook verificam entrega e lógica de tentativa de reenvio.

Monitores em 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 solicitação como cabeçalho, parâmetro de consulta ou campo do corpo. Por exemplo, a etapa 1 pode enviar um POST para /login e extrair um token JWT, a etapa 2 usa esse token no cabeçalho Authorization para GET /cart, e a etapa 3 usa o ID do carrinho da etapa 2 para POST /checkout. Cada etapa acompanha tempos, códigos de status e cargas 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 quando expirarem. Autenticação baseada em certificado (mTLS) é suportada para endpoints gRPC e HTTPS. Monitores SOAP suportam tokens de nome de usuário WS-Security e certificados X.509.

Sim. O Dotcom-Monitor importa coleções do 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 do Dotcom-Monitor. Fluxos de trabalho multi-etapas são preservados, e afirmações JSONPath podem ser adicionadas após a importação. Variáveis como {{baseUrl}} e {{authToken}} são mapeadas automaticamente para variáveis do Dotcom-Monitor.

Use afirmaçõ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 limiares de tempo de resposta (ex.: passo 1 < 500ms, passo 3 < 2000ms). A correspondência por padrão Regex está disponível para validação personalizada.

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

Sim. O Agente Privado do Dotcom-Monitor roda dentro da sua rede para monitorar APIs internas, ambientes de staging e endpoints protegidos por firewall. O agente conecta-se de saída à plataforma do Dotcom-Monitor (não são necessárias regras de firewall de entrada), executa monitores conforme seu cronograma e relata 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 fornece uma API REST e um provedor Terraform para gerenciar monitores como código. Você pode criar, atualizar ou excluir monitores a partir de pipelines CI/CD usando arquivos de configuração YAML. Acione verificações de API sob demanda a partir do Jenkins, GitLab CI, GitHub Actions ou CircleCI. Falhe builds se os tempos de resposta da API excederem os limites ou se as afirmações falharem. Exporte configurações de monitores para controle de versão para trilhas de auditoria.