d/domain
intelligence

API DNS · X402 · PROTÓTIPO TESTNET

DNS,
pronto para
o seu código.

Registos DNS e presença de políticas de email de um domínio numa resposta JSON. Um pagamento x402 por análise.

0,01 USDC de teste por análise · Apenas Base Sepolia

UMA CONSULTA. UM DIAGNÓSTICO.01 / 03
d/
AMXTXTAAAANSCAA
example.com→ application/json
O FLUXO X402
402Pagamento necessário
200Diagnóstico recebido

01 — O ÂMBITO

Sinais úteis.
Um formato simples.

Integre um primeiro diagnóstico num script, numa ferramenta interna ou num agente. Resultados explícitos, sem pontuações opacas.

01

Registos DNS

Consulta resolutores públicos sem se ligar ao servidor do domínio analisado.

AAAAAMXNSCAATXT
02

Presença de SPF e DMARC

Políticas presentes, ausentes ou múltiplas. Os erros de resolução são distintos da ausência de registos.

Resultados, sem pontuação.
03

Uma resposta JSON

Domínio normalizado, data e hora, resultados DNS, TTL disponíveis, estado da cache e limites da análise.

GET /v1/domain/check

02 — A RESPOSTA

Legível para si.
Pronta para
o seu código.

Uma estrutura que separa resultados DNS, observações de email e limites do diagnóstico.

Excerto ilustrativo, dados fictícios.
Esta página não executa análises nem inicia pagamentos.

Explorar o esquema completo
response.json · excerto
{
  "domain": "example.com",
  "status": "complete",
  "cached": false,
  "email": {
    "spf": {
      "status": "present",
      "records": ["v=spf1 -all"]
    },
    "dmarc": {
      "status": "absent",
      "records": []
    }
  }
}
Exemplo de estrutura · resposta abreviada

LIMITES EXPLÍCITOS

Um diagnóstico DNS.
Um âmbito definido.

Deteta a presença de SPF e DMARC; não valida integralmente as políticas nem avalia a entrega de email.

O DMARC é consultado no domínio exato, sem pesquisa alternativa no domínio organizacional.

Não avalia TLS, reputação ou segurança global do domínio. Os erros DNS são indicados explicitamente.

03 — EXPERIMENTE

Da primeira consulta
ao primeiro pagamento.

0,01 USDC

de teste / análise
Base Sepolia · chain ID 84532

01

Consultar o challenge

Sem pagamento, o endpoint de análise devolve HTTP 402 com as condições no cabeçalho PAYMENT-REQUIRED.

curl -i \
  'https://api.x4-02.fr/v1/domain/check?domain=example.com'

Verificar apenas o serviço: /health ↗ (gratuito).

02

Preparar o cliente Python

Descarregue o cliente e instale o SDK x402. A verificação inicial não precisa de chave nem efetua pagamentos.

python3 -m venv .venv
source .venv/bin/activate
pip install 'x402[evm]==2.26.0' web3
python client.py
Descarregar client.py Guia do GitHub
03

Pagar na testnet

Abasteça uma carteira dedicada com USDC de teste na Base Sepolia através do faucet da Circle ↗. Depois execute:

python client.py --pay

O cliente pede a chave privada sem a mostrar nem guardar. Utilize apenas uma carteira de teste dedicada.

Assinatura com verificações explícitas.

Antes de assinar, o cliente verifica a rede, o contrato USDC, o destinatário e o montante. Confirma a liquidação on-chain e a rejeição de reutilização. Não repete pagamentos automaticamente em caso de erro.

OS DETALHES IMPORTANTES

Antes de
ligar o seu código.

Está pronto para pagamentos reais?

Não. Apenas são aceites Base Sepolia (eip155:84532) e USDC de teste. O fluxo completo e a rejeição de reutilização foram testados; isto não é uma garantia de disponibilidade nem uma auditoria de segurança.

Preciso de uma chave API?

Não precisa de uma chave API. O x402 protege a análise. É necessária uma autorização de pagamento para obter o diagnóstico; /health continua gratuito.

Quais são os limites do protótipo?

Antes do pagamento: 60 pedidos por minuto e IP, até 16 pedidos ativos. Após validar o x402: 30 pedidos por minuto e IP, até oito análises simultâneas. Os limites estão na memória de um processo e são repostos ao reiniciar. Clientes com o mesmo IP público partilham a quota.

As respostas podem vir da cache?

Sim. Os resultados completos podem ficar em cache até 60 segundos, sem exceder o menor TTL DNS positivo. O campo cached indica-o. As respostas em cache também exigem pagamento por pedido.

Este site recolhe a minha chave privada?

Não. Esta página não liga carteiras nem pede segredos. O cliente Python corre na sua máquina e só pede uma chave com --pay. Nunca partilhe a sua chave com um site ou numa mensagem.