kisa-whois-domain
KISA WHOIS 서비스에서 .kr·.한국 도메인의 등록 정보를 조회합니다.
문법
옵션
- domain=STRING
- 필수 옵션. 조회 대상 도메인. .kr 또는 .한국 도메인만 지원합니다. 예:
example.kr - profile=STRING
- 선택 옵션. KISA WHOIS 접속 프로파일 식별자. 미지정 시 등록된 모든 KISA WHOIS 프로파일을 순회하며 각각 한 건씩 조회합니다. 예:
kisa_whois - locale=STRING
- 선택 옵션. 출력 언어.
ko또는en만 허용합니다. 등록인·관리자·등록 대행기관 명칭이 해당 언어로 반환됩니다. (기본값:ko) - pretty=BOOL
- 선택 옵션. 리스트 필드(
status,name_servers,name_server_ips)를 줄바꿈으로 구분된 텍스트로 출력합니다. (기본값:f)
출력 필드
| 필드 | 타입 | 이름 | 설명 |
|---|---|---|---|
| profile | 문자열 | 프로파일 | 조회에 사용된 접속 프로파일 식별자 |
| domain | 문자열 | 도메인 | 조회된 도메인 이름. 예: example.kr |
| registrant_name | 문자열 | 등록인 | 도메인 등록 기관 또는 개인명 |
| registrant_address | 문자열 | 등록인 주소 | 등록인 주소 |
| registrant_postal_code | 문자열 | 등록인 우편번호 | 등록인 우편번호 |
| admin_name | 문자열 | 관리자 | 도메인 관리자 이름 |
| admin_email | 문자열 | 관리자 이메일 | 도메인 관리자 이메일. 예: user@example.com |
| admin_phone | 문자열 | 관리자 전화번호 | 도메인 관리자 전화번호 |
| created | 날짜 | 등록일 | 도메인 최초 등록일 |
| updated | 날짜 | 최근 변경일 | 도메인 정보 최근 변경일 |
| expires | 날짜 | 만료일 | 도메인 만료일 (9999-12-31 은 만료일 미설정) |
| is_disclosed | 불리언 | 정보 공개 여부 | 등록인 정보 공개 여부 (true=공개) |
| registrar | 문자열 | 등록 대행기관 | 도메인 등록 대행 기관명 |
| registrar_url | 문자열 | 등록 대행기관 URL | 도메인 등록 대행 기관 URL |
| dnssec | 문자열 | DNSSEC | DNSSEC 적용 상태 |
| status | 문자열 목록 | 도메인 상태 | 도메인 상태 코드 목록 |
| name_servers | 문자열 목록 | 네임서버 | 권한 있는 네임서버 목록 |
| name_server_ips | 문자열 목록 | 네임서버 IP | 네임서버 IP 주소 목록 (누락 항목은 - 로 표기) |
> pretty=t 지정 시 status·name_servers·name_server_ips 는 줄바꿈으로 결합된 단일 문자열로 출력됩니다.
오류 코드
파싱 오류
| 오류 메시지 | 원인 | 해결 |
|---|---|---|
| 조회 대상 옵션(domain, ip, asn)을 입력하세요. | domain 옵션 누락 또는 빈 값 | domain= 에 조회할 도메인 지정 |
| 유효하지 않은 도메인입니다. .kr 또는 .한국 도메인만 지원합니다. | .kr·.한국 외 도메인 입력 | .kr 또는 .한국 도메인만 입력 |
| 유효하지 않은 locale 입니다. 'ko' 또는 'en'을 사용하세요. | locale 값이 ko/en 이 아님 | locale=ko 또는 locale=en 지정 |
| 사용 가능한 KISA WHOIS 프로파일이 없습니다. | (profile 미지정 시) 등록된 프로파일 없음 | KISA WHOIS 접속 프로파일을 먼저 등록 |
| KISA WHOIS 프로파일 이름을 입력하세요. | 지정한 profile 식별자가 존재하지 않음 | 올바른 프로파일 식별자 지정 |
런타임 오류
런타임 오류 발생 시 쿼리가 중단됩니다. 메시지는 kisa-whois-domain error: 접두사와 함께 표시됩니다.
| 오류 메시지 | 원인 | 해결 |
|---|---|---|
| KISA WHOIS API daily quota exceeded - 일일 호출 제한을 초과하였습니다. | 공공데이터포털 일일 호출 한도 초과 | 다음 날까지 대기하거나 한도 상향 신청 |
| KISA WHOIS API rate limit exceeded - 호출 속도 제한을 초과하였습니다. ... | 단시간 과다 호출로 속도 제한 | 잠시 후 재시도 |
| service_key is not configured for profile: <프로파일> | 프로파일에 service_key 미설정 | 프로파일에 공공데이터포털 인증키 설정 |
| KISA WHOIS API error (<코드>): <메시지> | API가 오류 코드 반환 | 메시지 확인 후 입력값·인증키 점검 |
설명
이 명령어는 공공데이터포털(data.go.kr)이 제공하는 KISA WHOIS OpenAPI(/B551505/whois/domain_name)를 호출하여 .kr·.한국 도메인의 등록 정보를 조회합니다. 프로파일에 등록된 공공데이터포털 인증키(service_key)를 사용하며, 호출당 도메인 한 건을 조회해 결과 레코드 한 건을 출력합니다.
profile 옵션을 생략하면 등록된 모든 KISA WHOIS 프로파일에 대해 각각 조회를 수행하고, 결과 레코드마다 사용한 프로파일 식별자가 profile 필드에 담깁니다. 단일 프로파일만 조회하려면 profile= 에 식별자를 지정하세요.
expires 가 9999-12-31 이면 만료일이 설정되지 않은 도메인을 의미합니다. KISA WHOIS는 공공데이터포털 인증키 단위로 일일 호출 한도와 호출 속도 제한이 적용되므로, 다량 조회 시 한도 초과 오류에 유의하세요.
여러 도메인을 한 번에 조회하려면 kisa-whois-domain-batch 명령어를 사용하세요.
사용 예
예시: 의심 도메인의 등록 정보 확인
상황: 피싱 의심 신고가 접수된 .kr 도메인의 등록인·등록일·만료일을 확인해 정상 등록 여부를 판단합니다.
예상 결과:
| domain | registrant_name | created | expires | is_disclosed |
|---|---|---|---|---|
| example.kr | 테스트기관 | 2003-01-15 | 9999-12-31 | true |
결과 해석: 등록일이 오래되고 등록인 정보가 공개된(is_disclosed=true) 도메인은 비교적 신뢰도가 높습니다. 등록일이 최근이고 정보가 비공개라면 추가 조사가 필요합니다.
예시: 네임서버 목록을 가독성 있게 출력
상황: 도메인의 권한 네임서버 구성을 한눈에 확인합니다.