DNS

DNS 카테고리에서는 도메인을 웹사이트 및 메일 서버와 연결하는 네임서버(Nameserver)와 DNS 레코드 관리를 다룹니다. Domain Name API의 기본 네임서버는 tr.apiname.com과 eu.apiname.com이며, 이 네임서버에 호스팅되는 DNS 영역(Zone)의 레코드는 REST API로 조회, 추가, 수정, 삭제할 수 있습니다.

A / AAAA — 도메인을 IPv4 / IPv6 주소에 연결합니다.

CNAME — www 같은 하위 도메인을 다른 호스트 이름의 별칭으로 지정합니다. 루트 도메인(Apex)에는 CNAME을 쓸 수 없으므로 ALIAS 레코드를 사용합니다.

MX — 메일을 받을 서버와 우선순위(Priority)를 지정합니다. 숫자가 낮을수록 먼저 사용됩니다.

TXT — SPF, DKIM, 도메인 소유 확인(Verification) 같은 텍스트 값을 저장합니다.

CAA — 이 도메인에 SSL 인증서를 발급할 수 있는 인증 기관(CA)을 제한합니다. SRV — 서비스의 호스트와 포트(Port)를 지정합니다.

네임서버 변경은 레지스트리에 몇 초 만에 반영되지만, 리졸버(Resolver)가 이전 정보를 캐시하므로 확장자에 따라 1~48시간이 걸릴 수 있습니다. 이미 위임된 영역의 레코드 변경은 해당 레코드의 TTL 안에 전파되므로, 큰 변경 전에는 TTL을 300초로 낮춰 두세요. 차일드 네임서버(Glue Record)와 DNSSEC 설정은 API 문서(Name servers, 영문)에서 확인할 수 있습니다.

DNS 레코드 엔드포인트(/api/v1/domains/zones)는 OT&E 테스트 환경에서 HTTP 500을 반환하므로 실제 환경에서 시험하세요. 네임서버가 위임되지 않은 도메인에 기록한 레코드는 질의에 응답하지 않으므로 운영 중인 사이트에 영향을 주지 않습니다. 반면 POST /api/v1/domains/zones/apply 호출은 도메인을 Domain Name API DNS로 옮기므로, 웹사이트나 메일이 다른 곳에서 운영 중인 도메인에는 사용하지 마세요. 변경 결과는 dig 또는 nslookup으로 각 네임서버에 직접 질의해 확인할 수 있습니다.