Referencia para desarrolladores

Verificación de Migración DNS

Consulta la documentación de la API de Verificación de Migración DNS, con parámetros de solicitud, campos de respuesta, ejemplos de código y gestión de errores para integraciones con DomScan.

Verificación de Migración DNS

Prepárate para una migración DNS sin problemas con una instantánea completa de tu configuración actual. Identifica todos los registros, configuraciones de TTL y posibles problemas antes de realizar cambios.

GET /v1/recipes/dns-migration

Parámetros de consulta

Parámetro	Tipo	obligatorio
domain	string	obligatorio
target_nameservers	string	opcional
critical_records	string	opcional

Campos de respuesta

Campo	Tipo
`success`	boolean
`data`	object
`data.domain`	string
`data.status`	string
`data.current_configuration`	object
`data.current_configuration.nameservers[]`	string[]
`data.current_configuration.records`	object
`data.current_configuration.records.A[]`	string[]
`data.current_configuration.records.MX[]`	string[]
`data.current_configuration.records.TXT[]`	string[]
`data.current_configuration.email_auth`	object
`data.current_configuration.email_auth.spf`	string
`data.current_configuration.email_auth.dkim_selectors[]`	string[]
`data.current_configuration.email_auth.dmarc`	string
`data.migration_checklist[]`	object[]
`data.migration_checklist[]`	object
`data.migration_checklist[].record_type`	string
`data.migration_checklist[].current_value`	string
`data.migration_checklist[].action`	string
`data.migration_checklist[].critical`	boolean
`data.migration_checklist[].ttl`	number
`data.warnings[]`	object[]
`data.warnings[]`	object
`data.warnings[].type`	string
`data.warnings[].message`	string
`data.warnings[].records[]`	string[]
`data.estimated_propagation`	string
`data.rollback_plan`	object
`data.rollback_plan.keep_old_records_until`	string
`data.rollback_plan.revert_steps[]`	string[]
`meta`	object
`meta.recipe_name`	string
`meta.credits_used`	number
`meta.credits_saved`	number
`meta.duration_ms`	number
`meta.components_called[]`	string[]
`meta.cached_components[]`	string[]
`meta.timestamp`	string
`errors[]`	array

Solicitud de ejemplo

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/recipes/dns-migration?domain=example.com&target_nameservers=ns1.newdns.net%2Cns2.newdns.net&critical_records=example.com"

Respuesta de ejemplo

{
  "success": true,
  "data": {
    "domain": "example.com",
    "status": "ready",
    "current_configuration": {
      "nameservers": [
        "ns1.current-dns.net",
        "ns2.current-dns.net"
      ],
      "records": {
        "A": [
          "198.51.100.8"
        ],
        "MX": [
          "10 mail.example.com"
        ],
        "TXT": [
          "v=spf1 include:_spf.google.com ~all"
        ]
      },
      "email_auth": {
        "spf": "v=spf1 include:_spf.google.com ~all",
        "dkim_selectors": [
          "google",
          "mail"
        ],
        "dmarc": "v=DMARC1; p=quarantine"
      }
    },
    "migration_checklist": [
      {
        "record_type": "MX",
        "current_value": "10 mail.example.com",
        "action": "migrate",
        "critical": true,
        "ttl": 3600
      }
    ],
    "warnings": [
      {
        "type": "ttl",
        "message": "High TTL values will slow cutover.",
        "records": [
          "A",
          "MX"
        ]
      }
    ],
    "estimated_propagation": "4-8 hours",
    "rollback_plan": {
      "keep_old_records_until": "48-72 hours after migration",
      "revert_steps": [
        "Keep screenshots of the current zone",
        "Restore old nameservers at the registrar if traffic fails"
      ]
    }
  },
  "meta": {
    "recipe_name": "dns-migration",
    "credits_used": 7,
    "credits_saved": 5,
    "duration_ms": 734,
    "components_called": [
      "dns",
      "dns-security",
      "ttl-analysis"
    ],
    "cached_components": [
      "dns"
    ],
    "timestamp": "2026-04-15T10:54:00Z"
  },
  "errors": []
}