DNS

Consulta DNS

Resolve um domínio contra três fontes ao mesmo tempo — os servidores autoritativos, o resolver do Google e o da Cloudflare — e diz se ele aparece em listas de bloqueio conhecidas.

DNS lookup

Resolves a domain against three sources at once — the authoritative servers, Google's resolver and Cloudflare's — and flags whether it shows up on known blocklists.

SYNC resposta na mesma chamada answers in the same call

Endpoint

GET /api/v1/dns/{domain} resolve um domínio resolves a domain

Parâmetros

Parameters

Nome	Name	Onde	In	Descrição	Description
`domain`	path	domínio válido, sem `http://` (ex.: `exemplo.com.br`)	a valid domain, without `http://` (e.g. `example.com`)

Exemplo

Example

curl https://dns.alicercelabs.com.br/api/v1/dns/exemplo.com.br \
  -H "Authorization: Bearer <token>"

{
  "success": true,
  "data": {
    "domain": "exemplo.com.br",
    "authoritative": {
      "servers": ["ns1.exemplo.com.br", "ns2.exemplo.com.br"],
      "records": [{ "type": "A", "value": "203.0.113.10" }]
    },
    "google": [{ "type": "A", "value": "203.0.113.10" }],
    "cloudflare": [{ "type": "A", "value": "203.0.113.10" }],
    "security": {
      "blocked_big": false,
      "blocked_nsfw": false
    }
  },
  "meta": { "elapsed_ms": 38, "request_id": "..." }
}

Erros possíveis

Possible errors

Status	Motivo	Reason
400	domínio inválido	invalid domain
401	token ausente ou inválido	missing or invalid token
429	limite de taxa excedido	rate limit exceeded
502	erro ao resolver o domínio nas fontes upstream	upstream resolution failed

Limites

Limits

10.000/dia · 416/hora, por IP chamador. As listas de bloqueio (blocked_big/blocked_nsfw) são carregadas em memória a partir de arquivos preparados por um worker offline — a checagem não faz nenhuma chamada externa extra.

10,000/day · 416/hour, per calling IP. Blocklists (blocked_big/blocked_nsfw) are loaded in memory from files an offline worker prepares — the check makes no extra outbound call.