Consulta DNS

Consulta registros DNS de un dominio con análisis de seguridad de correo electrónico (SPF, DKIM, DMARC). Soporta tipos de registro comunes incluyendo A, AAAA, MX, TXT, CNAME, NS y SOA.

Endpoint

GET /api/v1/dns/{domain}?type={recordTypes}

Autenticación

Todas las solicitudes requieren una API key enviada mediante el header X-Api-Key.

Parámetros

Parámetro	Tipo	En	Obligatorio	Descripción
domain	string	path	Sí	Nombre de dominio a consultar
type	string	query	No	Tipos de registro separados por comas (por defecto A)

Tipos de Registro Soportados

Tipo	Descripción
A	Dirección IPv4
AAAA	Dirección IPv6
MX	Servidor de intercambio de correo
TXT	Registros de texto (SPF, DKIM, etc.)
CNAME	Nombre canónico (alias)
NS	Servidor de nombres
SOA	Inicio de autoridad

Respuesta

{
  "domain": "example.com",
  "records": [
    {
      "type": "A",
      "name": "example.com",
      "value": "93.184.216.34",
      "ttl": 3600,
      "priority": null
    },
    {
      "type": "MX",
      "name": "example.com",
      "value": "mail.example.com",
      "ttl": 3600,
      "priority": 10
    },
    {
      "type": "TXT",
      "name": "example.com",
      "value": "v=spf1 include:_spf.google.com ~all",
      "ttl": 3600,
      "priority": null
    }
  ],
  "queryTimeMs": 42,
  "security": {
    "spf": {
      "present": true,
      "rawRecord": "v=spf1 include:_spf.google.com ~all",
      "qualifier": "~all",
      "mechanisms": ["include:_spf.google.com"]
    },
    "dkimFound": false,
    "dmarc": {
      "present": true,
      "rawRecord": "v=DMARC1; p=reject; rua=mailto:dmarc@example.com",
      "policy": "reject",
      "subdomainPolicy": "",
      "reportingEmail": "dmarc@example.com"
    }
  }
}

Campos de la Respuesta

Campo	Tipo	Descripción
domain	string	El nombre de dominio consultado
records	array	Array de objetos de registros DNS
queryTimeMs	integer	Tiempo de ejecución de la consulta en milisegundos
security	object	Análisis de seguridad de correo (SPF, DKIM, DMARC) -- ver más abajo

Objeto de Registro

Campo	Tipo	Descripción
type	string	Tipo de registro (A, AAAA, MX, TXT, CNAME, NS, SOA)
name	string	Nombre del registro (normalmente el dominio consultado)
value	string	Valor del registro (dirección IP, hostname, texto, etc.)
ttl	integer	Tiempo de vida en segundos
priority	integer	Valor de prioridad (solo para registros MX, null en caso contrario)

Análisis de Seguridad

El objeto security contiene el análisis de autenticación de correo electrónico del dominio.

Resultado SPF

Campo	Tipo	Descripción
present	boolean	Si se encontró un registro SPF
rawRecord	string	Valor del registro TXT SPF sin procesar
qualifier	string	Calificador por defecto (+all, -all, ~all, ?all)
mechanisms	array	Lista de mecanismos SPF (includes, IPs, etc.)

DKIM

Campo	Tipo	Descripción
dkimFound	boolean	Si se encontró un registro DKIM para selectores comunes

Resultado DMARC

Campo	Tipo	Descripción
present	boolean	Si se encontró un registro DMARC
rawRecord	string	Valor del registro TXT DMARC sin procesar
policy	string	Política DMARC (none, quarantine, reject)
subdomainPolicy	string	Política de subdominios (cadena vacía si no está configurada)
reportingEmail	string	Dirección de correo para informes agregados

Ejemplo

# Consultar registros A (por defecto)
curl -H "X-Api-Key: YOUR_API_KEY" \
  "https://api.iqxlookup.neivi.es/api/v1/dns/example.com"

# Consultar múltiples tipos de registro
curl -H "X-Api-Key: YOUR_API_KEY" \
  "https://api.iqxlookup.neivi.es/api/v1/dns/example.com?type=A,MX,TXT"