Desenvolvedores

API e webhooks VigiaMail

Integre checks de domínio, inventário e notificações de mudança no seu sistema. Credenciais são criadas dentro do painel por clientes com assinatura paga.

Gerar credenciais Ver planos

Autenticação OAuth2

Use o fluxo client_credentials. Envie client_id e client_secret por Basic Auth ou no corpo da requisição.

curl -X POST https://vigiamail.com.br/oauth/token \
  -u "CLIENT_ID:CLIENT_SECRET" \
  -d "grant_type=client_credentials"

GET

/api/v1/domains

Lista domínios ativos monitorados.

GET

/api/v1/domains/{domain}/health

Consulta o último diagnóstico salvo.

POST

/api/v1/checks/domain

Executa um check DNS sem alterar o inventário.

Exemplo de check

curl -X POST https://vigiamail.com.br/api/v1/checks/domain \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"domain":"exemplo.com.br"}'

Webhooks

Configure uma URL HTTPS no painel. O VigiaMail envia o evento domain.check.changed quando score ou status de uma verificação salva muda. A assinatura HMAC vem em X-VigiaMail-Signature.

{
  "type": "domain.check.changed",
  "createdAt": "2026-05-25T20:00:00.000Z",
  "data": {
    "domain": "cliente.com.br",
    "previous": { "score": 90, "status": "healthy" },
    "current": { "score": 60, "status": "warning" }
  }
}