d/domain
intelligence

API DNS · X402 · PROTOTIPO TESTNET

DNS,
listo para
tu código.

Registros DNS y presencia de políticas de correo de un dominio en una respuesta JSON. Un pago x402 por análisis.

0,01 USDC de prueba por análisis · Solo Base Sepolia

UNA CONSULTA. UN DIAGNÓSTICO.01 / 03
d/
AMXTXTAAAANSCAA
example.com→ application/json
EL FLUJO X402
402Pago requerido
200Diagnóstico recibido

01 — QUÉ ANALIZA

Señales útiles.
Un formato sencillo.

Integra un primer diagnóstico en un script, una herramienta interna o un agente. Resultados explícitos, sin puntuaciones opacas.

01

Registros DNS

Consulta resolutores públicos sin conectarse al servidor del dominio.

AAAAAMXNSCAATXT
02

Presencia de SPF y DMARC

Políticas presentes, ausentes o múltiples. Los errores de resolución se distinguen de la ausencia de registros.

Resultados, sin puntuación.
03

Una respuesta JSON

Dominio normalizado, fecha y hora, resultados DNS, TTL disponibles, estado de caché y límites del análisis.

GET /v1/domain/check

02 — LA RESPUESTA

Legible para ti.
Lista para
tu código.

Una estructura que separa los resultados DNS, las observaciones de correo y los límites del diagnóstico.

Extracto ilustrativo, datos ficticios.
Esta página no ejecuta análisis ni inicia pagos.

Explorar el esquema completo
response.json · extracto
{
  "domain": "example.com",
  "status": "complete",
  "cached": false,
  "email": {
    "spf": {
      "status": "present",
      "records": ["v=spf1 -all"]
    },
    "dmarc": {
      "status": "absent",
      "records": []
    }
  }
}
Ejemplo de estructura · respuesta abreviada

LÍMITES EXPLÍCITOS

Un diagnóstico DNS.
Un alcance definido.

Detecta la presencia de SPF y DMARC; no valida completamente las políticas ni evalúa la entregabilidad del correo.

DMARC se consulta en el dominio exacto, sin búsqueda alternativa en el dominio organizativo.

No evalúa TLS, reputación ni seguridad global del dominio. Los errores DNS se indican explícitamente.

03 — PRUÉBALO

De la primera consulta
al primer pago.

0,01 USDC

de prueba / análisis
Base Sepolia · chain ID 84532

01

Consultar el challenge

Sin pago, el endpoint de análisis devuelve HTTP 402 con las condiciones en la cabecera PAYMENT-REQUIRED.

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

Comprobar solo el servicio: /health ↗ (gratis).

02

Preparar el cliente Python

Descarga el cliente e instala el SDK x402. La comprobación inicial no necesita clave ni realiza pagos.

python3 -m venv .venv
source .venv/bin/activate
pip install 'x402[evm]==2.26.0' web3
python client.py
Descargar client.py Guía de GitHub
03

Pagar en testnet

Obtén USDC de prueba en Base Sepolia para una cartera dedicada mediante el faucet de Circle ↗. Después ejecuta:

python client.py --pay

El cliente solicita la clave privada sin mostrarla ni guardarla. Usa solo una cartera de prueba dedicada.

Firma con controles explícitos.

Antes de firmar, el cliente comprueba la red, el contrato USDC, el destinatario y el importe. Verifica la liquidación on-chain y el rechazo de reutilización. Los pagos fallidos no se reintentan automáticamente.

LOS DETALLES IMPORTANTES

Antes de
conectar tu código.

¿Está listo para pagos con dinero real?

No. Solo se aceptan Base Sepolia (eip155:84532) y USDC de prueba. Se han probado el flujo completo y el rechazo de reutilización; esto no es una garantía de disponibilidad ni una auditoría de seguridad.

¿Necesito una clave API?

No necesitas una clave API. x402 protege el análisis. Se requiere autorización de pago para obtener el diagnóstico; /health sigue siendo gratuito.

¿Cuáles son los límites del prototipo?

Antes del pago: 60 solicitudes por minuto e IP y hasta 16 activas. Tras validar x402: 30 solicitudes por minuto e IP y hasta ocho análisis simultáneos. Los límites están en memoria en un proceso y se reinician al arrancar. Los clientes con la misma IP pública comparten cuota.

¿Las respuestas pueden venir de la caché?

Sí. Los resultados completos pueden guardarse hasta 60 segundos, sin superar el menor TTL DNS positivo. El campo cached lo indica. Las respuestas en caché también requieren pago por consulta.

¿Este sitio recopila mi clave privada?

No. Esta página no conecta carteras ni pide secretos. El cliente Python se ejecuta en tu equipo y solo pide una clave con --pay. Nunca compartas tu clave con un sitio web ni en un mensaje.