Home » Recursos » API de Monitoramento
  • REST Web API
  • JSON
  • Serviço de Relatórios XML
  • Webhooks
  • Pronto para CI/CD

Automatize Cada Parte do Seu Monitoramento com a Dotcom-Monitor API

Crie monitores programaticamente, gerencie dispositivos e tarefas, orquestre testes de carga e transmita dados de desempenho em tempo real para seus próprios painéis, SIEMs e pipelines CI/CD — com uma API REST documentada e o Serviço de Relatórios XML (XRS).
Comece Seu Teste Grátis de 30 Dias
Agendar uma Demonstração
Three floating dark-mode cards on a deep navy background — a Web API JSON request creating a new HTTPS monitor, an XRS XML response with a timing breakdown, and a live API-surface KPI panel showing requests, devices, locations, sessions, and last deploy.
  • Não é necessário cartão de crédito
  • Configuração em menos de 5 minutos
  • Acesso completo à API incluído em todos os planos pagos
  • Suporte especializado 24×7
10.000+

Organizações no Mundo Todo

99,99%

SLA de Disponibilidade da Plataforma

30+

Locais Globais de Monitoramento

Desde 1998

Líder em Monitoramento de Websites

Monitoramento Programático

O Que É a API Dotcom-Monitor?

A plataforma Dotcom-Monitor é totalmente scriptável. Tudo o que você pode fazer na interface web — desde criar um novo monitor HTTP até gerar um relatório de desempenho de três meses — pode ser feito programaticamente através de dois serviços complementares: a API Web baseada em REST para configuração e o XML Reporting Service (XRS) para extração de dados em tempo real.

A API Web é uma interface HTTP estruturada, baseada em JSON, que expõe operações de monitoramento e teste de carga para seus próprios sistemas. Use-a para provisionar novos monitores a cada implantação, gerenciar milhares de dispositivos sob configuração como código, integrar monitoramento às suas ferramentas de ticketing existentes ou incorporar dados de desempenho ao vivo em páginas de status voltadas ao cliente.

O XML Reporting Service (XRS) é um feed de dados sob demanda gratuito que retorna resultados de monitoramento como documentos XML. Aponte-o para qualquer painel de relatórios, ferramenta de BI, planilha Excel ou banco de dados interno para construir visualizações personalizadas sem depender da engenharia.

Juntos, eles dão às suas equipes de plataforma, SRE e DevOps controle programático total — sem necessidade de cliques na interface.

  • Configure monitores HTTPS, REST, SOAP, GraphQL, WebSocket, ServerView, BrowserView, UserView e MetricsView via JSON
  • Importe, atualize e remova dispositivos, tarefas, grupos e agendadores em larga escala
  • Extraia dados de desempenho brutos ou agregados (resumos horários, diários, semanais, mensais, anuais)
  • Provisione monitoramento a partir de Jenkins, GitHub Actions, Azure DevOps, GitLab CI ou qualquer pipeline compatível com HTTP

API Web — Referência Rápida

https://api.dotcom-monitor.com/config_api_v1/

Formato

JSON request / JSON response

Métodos

GET (leitura) · POST / PUT (escrever / atualizar)

Autenticação

Por requisição, sessão de 60 segundos; whitelist de IP opcional

Transporte

HTTP ou HTTPS

XRS — Referência Rápida

https://xmlreporter.dotcom-monitor.com/reporting/xml/

Formato

Resposta XML via HTTP(S) GET

Autenticação

UID da Conta (PID) gerado em Gerenciar > Integrações

Profundidade dos Dados

Respostas brutas de até 6 meses atrás

Custo

Grátis, incluído em todas as contas

1

Gerar uma Chave

Crie uma integração Web API ou XML Feed na sua conta.

2

Configurar

POST JSON para criar dispositivos, tarefas, grupos, agendas e alertas.
3

Monitorar

Execuções realizadas de 30+ locais globais no seu cronograma definido.
4

Extrair

Extraia resultados via XRS para dashboards, BI, Excel ou apps internos.
Capacidades Principais da API

Tudo que a Interface Pode Fazer — Como Código

Cada objeto de monitoramento na sua conta é um recurso API de primeira classe. Gerencie-os individualmente ou em massa através de ambientes.

Configuração Completa do Monitor

  • Criar e editar monitores HTTPS, REST, SOAP, GraphQL e API de múltiplas etapas
  • Configurar dispositivos BrowserView, UserView, ServerView e MetricsView
  • Anexar autenticação: OAuth 2.0, chaves de API, tokens Bearer, Basic, NTLM, mTLS
  • Definir asserções JSONPath / XPath e validação personalizada de resposta

Gerenciamento de Dispositivos, Tarefas e Grupos

  • Provisionar dispositivos e as tarefas que pertencem a eles
  • Organizar monitores em grupos com alertas e filtros herdados
  • Aplicar alterações de configuração em massa através dos ambientes
  • Clonar dispositivos entre contas de staging, QA e produção

Locais e Agendas

  • Listar todos os locais globais de monitoramento disponíveis
  • Atribuir verificações a regiões específicas ou aos seus Agentes Privados
  • Criar agendas baseadas em tempo (horário comercial, janelas de manutenção)
  • Aplicar filtros programaticamente para suprimir ruídos conhecidos

Alertas e Integrações de Notificação

  • Criar, atualizar e direcionar grupos de alerta via API
  • Gerenciar listas de destinatários, políticas de escalonamento e rotações de plantão
  • Enviar notificações para Slack, PagerDuty, Teams, OpsGenie, webhooks
  • Automatizar ajuste de escalonamento sem usar a interface

Feed de Relatórios em Tempo Real XRS

  • Obter dados de uptime, tempo de resposta, TTFB e erros sob demanda
  • Retornar respostas brutas ou resumos (hora / dia / semana / mês / ano)
  • Filtrar por dispositivo, localização, agenda, sucesso / falha, departamento
  • Transmita para SQL, Excel, Power BI, Grafana ou painéis personalizados
Como Funciona

Do Zero ao Monitoramento Automatizado em Quatro Passos

Não é necessário instalar SDK. Se o seu sistema pode fazer uma requisição HTTP, ele pode se comunicar com o Dotcom-Monitor.

01

Crie uma Integração

Na sua conta Dotcom-Monitor, vá em Gerenciar > Integrações e crie uma nova integração Web API (para configuração) ou XML Feed (para relatórios). Opcionalmente, restrinja o acesso por endereço IP.

02

Autentique-se

Cada requisição autentica contra sua integração. Sessões expiram após 60 segundos de inatividade, garantindo acessos curtos e seguros. Requisições XRS usam seu UID de Conta (PID) gerado.

03

Envie Requisições JSON

Use GET para leituras ou POST/PUT para gravações. Defina Content-Type: application/json ao enviar um corpo. Erros retornam JSON estruturado.

04

Automatize em Todo Lugar

Conecte a API ao Terraform, Jenkins, GitHub Actions, Azure DevOps ou seus próprios scripts. Dispare criação de monitor no deploy, puxe dados de desempenho para BI ou envie alertas automáticos em falhas de SLA.

Especificações Técnicas

Duas APIs. Uma Conta. Controle Completo.

A Web API gerencia a configuração; XRS gerencia os relatórios. Elas compartilham um único modelo de autenticação e funcionam com todas as soluções Dotcom-Monitor.

Web API (Configuração & Controle)

Gerencie sua infraestrutura de monitoramento programaticamente.

URL Base

api.dotcom-monitor.com/config_api_v1/

Protocolos

HTTP, HTTPS

Formato da requisição

JSON (application/json)

Formato da resposta

JSON

Métodos

GET (leitura) · POST, PUT (escrever / atualizar)

Autenticação

Chave de Integração da API Web, sessão por requisição (timeout de 60s)

Controle de acesso

Lista branca de IP opcional

Cobre

Métodos de Monitoramento + LoadView

Objetos gerenciados

Dispositivos, tarefas, grupos, agendas, filtros, alertas, locais, testes de carga, usuários

Tratamento de erros

JSON estruturado com códigos de erro e mensagens

Serviço de Relatórios XML (XRS)

Transmita dados de monitoramento em tempo real para qualquer coisa que suporte XML.

URL Base

xmlreporter.dotcom-monitor.com/reporting/xml/

Protocolos

HTTP, HTTPS

Formato da requisição

HTTP(S) GET com parâmetros de URL

Formato da resposta

Documento XML

Autenticação

UID da Conta (PID), gerado como uma integração XML Feed

Escopo

Abrangência da conta ou limitado a Departamentos específicos

Tipos de relatório

Configuração do dispositivo, status, respostas brutas, resumos (hora / dia / semana / mês / ano), estatísticas dos últimos 3 meses

Janela de dados

Até os últimos 6 meses para respostas brutas

Filtros

Localização, agenda, dispositivo, sucesso / falha, departamento, intervalo de datas

Destinos de saída

Dashboards, SQL, Excel, Power BI, aplicativos personalizados

Amigável para Desenvolvedores

HTTP simples.
Sem necessidade de SDKs.

Cada objeto de monitoramento — dispositivos, tarefas, alertas, grupos, agendas — é representado como um recurso JSON. Veja como é puxar dados de monitoramento do XRS e inserir um novo dispositivo via Web API. Use isso em um curl, um script bash, um job Python, ou uma etapa CI — o que sua equipe já utilizar.

Os campos retornados incluem DnsTime, SSLTime, ConnectionTime, RequestTime, FirstPacketTime (TTFB), DownloadTime e Duration, além de localização, status e timestamp de monitoramento — prontos para serem inseridos em qualquer visualização de cascata.

# Puxar relatório XRS em tempo real — resumo por localização
GET https://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx
     ?PID=4229AF4F0FB545AEA75EAF2013E51BB7
     &Site=12345
     &Type=Overall
     &location=NY, USA

# Resposta (resumida)
<Response>
  <ID>3424533543</ID>
  <Name>Checkout API</Name>
  <URL>https://shop.example.com/api/checkout</URL>
  <Duration>114</Duration>
  <DnsTime>0</DnsTime>
  <SSLTime>18</SSLTime>
  <ConnectionTime>15</ConnectionTime>
  <FirstPacketTime>97</FirstPacketTime>
  <DownloadTime>2</DownloadTime>
  <Status>S</Status>
</Response>

# Criar um novo monitor HTTPS via Web API
POST https://api.dotcom-monitor.com/config_api_v1/devices
Content-Type: application/json

{
  "name": "Checkout API — Produção",
  "platform": "HTTPS",
  "tasks": [{
    "url": "https://shop.example.com/api/checkout",
    "method": "POST",
    "keyword": "order_id"
  }],
  "frequency": 60,
  "locations": ["NY-USA", "FR-PARIS", "SG"]
}

Comece a Automatizar Seu Monitoramento em 5 Minutos

Todo plano pago inclui acesso completo à Web API e XRS — sem addons, sem cobrança por chamada, sem níveis extras de faturamento.

Comece Seu Teste Grátis de 30 Dias
Agendar uma Demonstração
  • Não é necessário cartão de crédito
  • Cancele a qualquer momento
  • Suporte especializado 24×7
Casos de Uso

O que as equipes constroem com a API

Equipes de plataforma, SREs e engenheiros DevOps usam a API Dotcom-Monitor para integrar o monitoramento aos fluxos de trabalho que já utilizam.

Monitoramento como Código

Versione cada monitor ao lado do serviço que protege. Provisione, atualize e aposente dispositivos através do seu pipeline Terraform ou Pulumi existente — sem desvios entre staging e produção.

Testes Rápidos Pós-Deploy

Acerte verificações HTTPS e transações multi-etapas sob demanda pelo Jenkins, GitHub Actions ou Azure DevOps após cada deploy. Falhe o build quando uma nova versão quebrar um endpoint crítico.

Páginas de Status e Dashboards Personalizados

Alimente dados XRS em páginas de uptime para clientes, displays internos de NOC ou relatórios executivos de SLA. Puxe apenas os campos que desejar, formatados exatamente como necessita.

Evidência de SLA e Relatórios de Conformidade

Automatize exportações mensais de SLA (percentual de uptime, tempos de resposta P95 / P99, incidentes de downtime) diretamente do XRS para Excel ou PDF — documentado, com timestamp e pronto para auditoria.

Provisionamento em Massa de Dispositivos

Ative centenas de monitores em uma única vez após uma aquisição, migração ou corte de CDN. Clone templates de dispositivos existentes e atribua os grupos, agendas e rotas de alerta corretos em escala.

Incorporação de Dashboard de Terceiros

Direcione dados de monitoramento para Grafana, Power BI, Tableau ou Datadog junto com sua outra telemetria — verificações sintéticas externas correlacionadas com traços internos de APM.

Gerenciamento de Contas Multi-Inquilino

MSPs e equipes empresariais podem gerenciar centenas de departamentos e milhares de dispositivos em varreduras programáticas únicas, com feeds XRS específicos por departamento para cada cliente.

Enriquecimento de Incidentes

Quando um monitor dispara, puxe o waterfall, cipher e o detalhamento de tempo via XRS e anexe automaticamente ao incidente do PagerDuty ou ServiceNow — reduzindo o tempo de triagem.

Análise Profunda do XRS

Relatórios em Tempo Real, Exatamente do Seu Jeito

O XML Reporting Service é um feed flexível, gratuito e sob demanda. Solicite dados resumidos ou respostas brutas. Filtre por localização, programação ou estado de sucesso. Retorne apenas os campos que você precisa.

Tipo de relatório
O que você recebe
Uso típico
Utilização da conta
Recursos usados e disponíveis por solução de monitoramento
Planejamento de licença e capacidade, reconciliação de faturamento
Status do dispositivo
Estado atual e status de dispositivos individuais ou conjuntos
Páginas de status ao vivo, painéis de parede NOC
Detalhes da resposta
Tempos e conteúdos altamente personalizáveis por requisição
Diagnósticos detalhados, waterfalls personalizados, enriquecimento de incidentes
Configuração do dispositivo e tarefa
Snapshots exportados da configuração de monitoramento
Backups, clonagem entre ambientes, trilhas de auditoria
Dados resumidos
Tempo ativo, tempo inativo, contagem de sucessos, contagem de falhas, performance, desvio padrão
Resumos executivos, relatórios SLA
Respostas brutas
Cada resultado de verificação para um dispositivo, até 6 meses atrás
Análise forense, comparações históricas
Agregados por hora
Dados de resposta agrupados em janelas de 1 hora
Identificação de pico de carga, análise de tendência horária
Agregados diários
Dados de resposta agrupados em janelas de 24 horas
Revisões diárias de operações, comparações dias úteis vs. finais de semana
Semanal / mensal / anual
Sumários em horizontes de tempo mais longos
Tendências em nível de diretoria, relatórios de desempenho Ano a Ano
Estatísticas de 3 meses
Dados estatísticos calculados em uma janela móvel de 3 meses
Alertas derivados da linha de base, detecção de anomalias

Cada relatório pode ser filtrado por local de monitoramento, cronograma, Filtro Dotcom-Monitor, estado de sucesso ou falha, departamento e intervalo de datas personalizado.

Por Que as Equipes Usam a API

Construído para DevOps, SRE & Engenharia de Plataforma

A API do Dotcom-Monitor elimina cliques manuais da interface no seu fluxo de trabalho de monitoramento para que sua equipe possa ampliar a cobertura sintética sem aumentar o quadro de pessoal.

Eliminar Deriva

Mantenha a configuração de monitoramento no controle de versão. Aplique os mesmos monitores em ambientes diferentes com confiança.

Antecipe o Monitoramento

Adicione verificações sintéticas no mesmo PR do serviço que elas cobrem. O monitoramento chega junto com o código, não semanas depois.

Escale Sem Cliques

Integre cem novos domínios ou mil novos endpoints com um único script. Sem fadiga de cliques.

Segurança Granular

Sessões de curta duração, whitelist opcional de IP e chaves de integração limitadas ao departamento mantêm o acesso restrito.

Serve para Qualquer Stack

HTTP simples + JSON (ou GET + XML para relatórios). Sem dependência de SDK. Funciona com qualquer linguagem e ferramenta CI/CD.

Tenha Controle dos Seus Dados

Extraia seus dados de monitoramento para seu próprio data warehouse, plataforma BI ou arquivo de conformidade na sua agenda.

Superfície Unificada

Uma API única abrange monitoramento e LoadView load testing — sem ferramenta separada, sem credenciais separadas.

Sem Custo Extra

O acesso à API e XRS está incluído em todos os planos pagos. Sem medição por chamada, sem cobrança extra para automação.

O Que Nossos Clientes Dizem

"Uma das melhores funcionalidades do Dotcom são as capacidades da API push/pull que nos fornecem dados de desempenho da rede. Usamos isso para monitorar problemas de desempenho, assim como estatísticas de carregamento das páginas. O Dotcom-Monitor nos permite monitorar múltiplos serviços dentro de uma única interface e plataforma. Isso nos permitiu operar com mais eficiência."
Gregory S.
Gerente, Mídia de Radiodifusão · Avaliação verificada no Capterra

Pronto para Colocar Seu Monitoramento no Piloto Automático?

Cada teste gratuito de 30 dias inclui acesso completo à Web API e XRS — além de todas as soluções de monitoramento, todas as localizações e todas as integrações. Veja como é o monitoramento automatizado.

Começar Teste Gratuito
Leia a Documentação da API
  • Configure em menos de 5 minutos
  • Não é necessário cartão de crédito
Perguntas Frequentes

Dúvidas Comuns Sobre a API do Dotcom-Monitor

A Web API (config_api_v1) é uma interface REST baseada em JSON para criar e gerenciar configurações de monitoramento — dispositivos, tarefas, grupos, cronogramas, alertas e testes de carga. O Serviço de Relatórios XML (XRS) é um feed gratuito separado que retorna resultados de monitoramento em XML via HTTP GET. A maioria das equipes usa ambos: Web API para configurar, XRS para extrair resultados.

Na sua conta Dotcom-Monitor, vá para Gerenciar > Integrações > Nova Integração e crie uma integração Web API (para configuração) ou uma integração XML Feed (para XRS). Toda requisição da Web API autentica contra essa integração e sessões expiram após 60 segundos de inatividade. O XRS usa o UID da Conta gerado como um parâmetro de URL PID. Você também pode restringir o acesso por endereço IP.

A Web API é totalmente JSON — tanto nos corpos das requisições quanto nas respostas. Defina Content-Type: application/json ao enviar um corpo JSON. O XRS retorna documentos XML via HTTP(S) GET, então a requisição é apenas uma URL com parâmetros de consulta.

A Web API cobre todas as plataformas de monitoramento Dotcom-Monitor: HTTPS, REST, SOAP, GraphQL, WebSocket, ServerView, BrowserView, UserView (scripts EveryStep) e MetricsView — assim como todos os monitores de protocolo (DNS, SSL, Email, FTP, ICMP Ping, TCP Port, Traceroute, VoIP e mais). Também cobre toda a superfície de testes de carga do LoadView.

O acesso à API e ao XRS está incluído em todos os planos pagos — não há medição por chamada nem taxa adicional. Sessões expiram após 60 segundos de inatividade, o que naturalmente limita scripts de longa execução. Se precisar de acesso restrito por IP ou throughput de nível empresarial, contate o Vendas sobre as opções Enterprise.

O XRS pode retornar dados brutos de resposta dos últimos 6 meses. Relatórios resumidos e estatísticos (agregados por hora / dia / semana / mês / ano e estatísticas de 3 meses) estão disponíveis para períodos maiores. Você especifica a data/hora inicial e final para cada relatório.

Sim — qualquer ferramenta que possa fazer uma chamada HTTP pode usar a API. Equipes comumente integram com Jenkins, GitHub Actions, GitLab CI, Azure DevOps, CircleCI e Terraform para provisionar monitores na implantação, executar smoke tests pós-release, e liberar deploys em produção baseados na saúde do monitoramento.

Sim. Ao criar uma Integração Web API, você pode permitir acesso de todas as requisições autenticadas ou restringir o acesso a uma lista de endereços IP confiáveis. Veja o artigo Como colocar IPs na whitelist para acesso Web API na Base de Conhecimento para detalhes.

Sim. Usuários numa conta root podem gerenciar departamentos programaticamente e uma integração XML Feed pode ser limitada a departamentos específicos. Usuários limitados a departamentos só podem puxar relatórios XRS para seu próprio departamento, o que suporta separação limpa para MSPs e configurações multi-tenant.

A documentação completa está na Base de Conhecimento Dotcom-Monitor, incluindo o guia Introdução à API, as referências de métodos de Monitoramento e LoadView com exemplos em JSON, e a referência de parâmetros de requisição XRS. Templates de código prontos para uso estão disponíveis na seção Exemplos de Código.

Automatize o Monitoramento.Recupere o Tempo dos Engenheiros.

Junte-se a mais de 10.000 organizações usando Dotcom-Monitor para detectar falhas antes dos clientes — e usar a API e o XRS para tornar essa cobertura fácil de gerenciar.

Iniciar Teste Gratuito — Sem Cartão de Crédito
Ver Preços
  • Teste gratuito com acesso total por 30 dias
  • Plano gratuito disponível
  • Cancele a qualquer momento