Ontwikkelaarsreferentie

DNS-migratiecontrole API-documentatie

DNS-migratiecontrole API-documentatie: Bereid je voor op een soepele DNS-migratie met een volledige momentopname van je huidige configuratie. Identificeert alle records, TTL-instellingen en potentiële problemen voordat je wijzigingen aanbrengt.

DNS-migratiecontrole

Bereid je voor op een soepele DNS-migratie met een volledige momentopname van je huidige configuratie. Identificeert alle records, TTL-instellingen en potentiële problemen voordat je wijzigingen aanbrengt.

GET /v1/recipes/dns-migration

Queryparameters

Parameter	Type	vereist
domain	string	vereist
target_nameservers	string	optioneel
critical_records	string	optioneel

Antwoordvelden

Veld	Type
`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

Voorbeeldverzoek

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"

Voorbeeldantwoord

{
  "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": []
}