Referencia para Desarrolladores

Verificación de Migración DNS Documentación API

Verificación de Migración DNS Documentación API: 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.

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": 6,
    "credits_saved": 6,
    "duration_ms": 734,
    "components_called": [
      "dns",
      "dns-security",
      "ttl-analysis"
    ],
    "cached_components": [
      "dns"
    ],
    "timestamp": "2026-04-15T10:54:00Z"
  },
  "errors": []
}