개발자 참고자료

DNS 마이그레이션 점검 API 문서

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