ForHosting KIT · Monitorar sites

Propagação de DNS

Depois de trocar o DNS, cada canto da internet fica sabendo da mudança numa hora diferente. Esta verificação consulta servidores distintos, compara as respostas e mostra se o valor novo já venceu o antigo. Para quem migrou site ou e-mail e precisa saber quando a virada realmente terminou.

● Estávelpor domínioUS$ 0,002

Executar — US$ 0,002 Ver a API

Use pelo WebAPIE-mailApp em breveTelegram em breve

Rode online

Rode nos nossos servidores com a sua conta. As ferramentas grátis rodam no seu navegador; esta aqui é descontada do seu saldo do KIT pelo preço acima.

Propagação sem mistério

DNS funciona com cache: cada resolvedor guarda a resposta por um tempo (o TTL) antes de perguntar de novo. Por isso a mudança não chega a todo mundo ao mesmo tempo — pode levar de minutos a dois dias, dependendo do TTL que estava configurado antes da troca. Não é defeito, é o desenho do sistema; o que dá para fazer é medir o avanço em vez de esperar no escuro, recarregando o site e torcendo.

Como a verificação enxerga a virada

A consulta pergunta o mesmo registro a servidores DNS diferentes e devolve as respostas lado a lado. Enquanto parte deles responder o valor antigo, a propagação está no meio do caminho; quando todos convergem no valor novo, a virada terminou. Rodando a verificação de tempos em tempos — na mão ou por script — você acompanha o progresso com dado concreto e decide com segurança a hora de desligar o servidor antigo.

Migração de madrugada, conferência automática

O ritual de virar site de madrugada combina com automação: agende chamadas à API a cada 30 minutos e vá dormir. A US$ 0,002 por verificação, uma noite inteira de acompanhamento custa menos de US$ 0,04. E uma dica de veterano que vale ouro: dias antes da migração, reduza o TTL dos registros que vão mudar — a propagação da troca fica muito mais rápida, e a janela de incerteza encolhe de horas para minutos.

Casos de uso

Virada de hospedagem no domingo

A loja da Padaria Pão Dourado migrou de servidor no domingo às 2h. As verificações agendadas mostraram a convergência completa antes das 8h — e a equipe desligou a hospedagem antiga sem medo de derrubar cliente no meio do caminho.

Troca de provedor de e-mail

A Distribuidora Horizonte Verde trocou os MX para um provedor novo. Até a propagação terminar, mensagens podiam cair dos dois lados; acompanhar a convergência definiu o momento certo de desativar as caixas antigas.

Entrega de site sem constrangimento

Carlos Eduardo Souza entregou o site novo e o cliente reclamou: “aqui ainda abre o antigo”. A verificação mostrou a propagação pela metade — resposta técnica, com dado, no lugar de um sem-graça “espera mais um pouco”.

Perguntas frequentes

Quanto tempo demora a propagação de DNS?

De minutos a até 48 horas, na prática — quem manda é o TTL configurado antes da mudança e o comportamento dos caches pelo caminho. A verificação serve exatamente para trocar essa estimativa por uma medição real.

Dá para acelerar a propagação?

A troca em si, não — caches alheios expiram no ritmo deles. Mas dá para preparar: abaixe o TTL dos registros dias antes da mudança e a virada será rápida. Depois, restaure o TTL de costume.

O que significa quando as respostas divergem?

Que parte dos servidores ainda entrega o valor antigo: a propagação está em andamento. É o estado normal do meio da migração — a virada só termina quando todas as respostas convergem no valor novo.

Qual a diferença para a consulta de DNS comum?

A consulta comum mostra os registros de um ponto de vista; esta compara vários pontos de vista ao mesmo tempo. Uma responde “o que está publicado?”; a outra, “a mudança já chegou em todo lugar?”.

Quanto custa acompanhar uma migração inteira?

A US$ 0,002 por verificação, checar a cada meia hora por 48 horas custa cerca de US$ 0,19. Pagamento por uso, via PayPal, sem cadastro nem assinatura.

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

POSThttps://api.kit.forhosting.com/web/dns-propagation

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

curl -X POST https://api.kit.forhosting.com/web/dns-propagation \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"domain":"ejemplo.com"}'

const res = await fetch("https://api.kit.forhosting.com/web/dns-propagation", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "domain": "ejemplo.com"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/web/dns-propagation",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "domain": "ejemplo.com"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/web/dns-propagation", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"domain":"ejemplo.com"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"domain":"ejemplo.com"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/web/dns-propagation", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemplo de requisição

{
  "domain": "ejemplo.com"
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "web.dns_propagation",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Limites

`timeout_sec`	30
`max_crawl_pages`	25

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →