مرجع المطورين

فحص ترحيل DNS

باستخدام DomScan API، استعد لترحيل DNS سلس مع لقطة كاملة لتكوينك الحالي. يحدد جميع السجلات وإعدادات TTL والمشاكل المحتملة قبل إجراء التغييرات.

فحص ترحيل DNS

استعد لترحيل DNS سلس مع لقطة كاملة لتكوينك الحالي. يحدد جميع السجلات وإعدادات TTL والمشاكل المحتملة قبل إجراء التغييرات.

GET /v1/recipes/dns-migration

معاملات الاستعلام

المعامل	النوع	مطلوب
domain	string	مطلوب
target_nameservers	string	اختياري
critical_records	string	اختياري

حقول الرد

الحقل	النوع
`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

طلب مثال

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"

مثال الرد

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