POST AI agent ready /v1/email-security/report

API de relatório de segurança de e-mail - auditoria SPF, DMARC e DKIM

Envie um nome de domínio e receba uma auditoria completa de autenticação de e-mail. O endpoint verifica os registros SPF, DMARC e DKIM, atribui uma nota (A a F) com uma pontuação numérica de 100 e retorna recomendações práticas para melhorar a postura de segurança de e-mail.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/email-security/report \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.com"}'

When to use this API

Auditorias de capacidade de entrega de e-mail

Execute esta verificação antes de lançar campanhas por e-mail para confirmar se SPF, DMARC e DKIM estão configurados corretamente. Um registro ausente ou configurado incorretamente pode enviar seus e-mails diretamente para pastas de spam.

Verificações de conformidade para certificações de segurança

Os auditores SOC 2 e ISO 27001 perguntam sobre controles de autenticação de e-mail. Gere este relatório como evidência de que SPF, DMARC e DKIM estão em vigor e configurados corretamente.

Monitoramento de segurança de domínio

Agende auditorias semanais de seus domínios de produção. Alerte sua equipe de segurança quando a nota cair ou quando um registro previamente configurado desaparecer.

Frequently asked questions

Como a nota é calculada?

A pontuação é baseada na presença e força dos registros SPF, DMARC e DKIM. FPS com pontuações -all superiores a ~all. DMARC com pontuações de rejeição superiores a quarentena ou nenhuma. Registros ausentes reduzem significativamente a pontuação.

Qual seletor DKIM ele verifica?

O endpoint verifica seletores comuns, incluindo "google", "default", "selector1" e "selector2". Se o seu seletor não for padrão, o DKIM poderá aparecer como não encontrado, mesmo que exista.

Este endpoint pode detectar falsificação de e-mail?

Ele não verifica falsificação ativa. Ele avalia se seus registros DNS estão configurados para evitar falsificação. Uma configuração forte de SPF, DMARC e DKIM torna a falsificação de seu domínio significativamente mais difícil.

O que rua e ruf significam na seção DMARC?

rua é o endereço que recebe relatórios agregados do DMARC (resumos diários). ruf é o endereço para relatórios forenses (notificações de falhas individuais). Ambos são opcionais, mas recomendados.

Isso funciona para subdomínios?

Sim. O DMARC herda do domínio pai se não existir nenhum registro específico do subdomínio. SPF e DKIM são verificados diretamente no subdomínio que você fornece.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.