nomadamas__k-skill/docs/features/kr-whois-lookup.md

KR WHOIS 조회 가이드

이 기능으로 할 수 있는 일

• 공공데이터포털 WHOIS API를 k-skill-proxy로 호출해 .kr/.한국 도메인, IPv4/IPv6, AS 번호의 공개 등록정보를 조회
• 사용자 쪽 API 키 없이 hosted proxy로 바로 사용

가장 중요한 규칙

조회는 hosted proxy의 /v1/kr-whois/...로 처리한다. DATA_GO_KR_API_KEY는 프록시 서버에만 두고, 공공데이터포털 15094277 활용신청이 승인돼 있어야 한다.

.com/.net 등 해외 gTLD, 개인정보 비공개 우회, 대량 수집, 역방향 DNS·포트 스캔은 범위 밖이다.

지원 endpoint

route	입력
GET /v1/kr-whois/domain	.kr/.한국 도메인
GET /v1/kr-whois/ip	IPv4/IPv6
GET /v1/kr-whois/as	AS9700 형식 AS 번호

예시

BASE="${KSKILL_PROXY_BASE_URL:-https://k-skill-proxy.nomadamas.org}"

curl -fsS --get "$BASE/v1/kr-whois/domain" \
  --data-urlencode "domain=kisa.or.kr"

curl -fsS --get "$BASE/v1/kr-whois/ip" \
  --data-urlencode "ip=202.30.50.51"

curl -fsS --get "$BASE/v1/kr-whois/as" \
  --data-urlencode "asn=AS9700"

도메인 URL은 scheme/path를 제거하고 .kr/.한국만 남긴다. 요약은 등록기관, 날짜, 상태, 네임서버 또는 네트워크 범위 등 공개 필드만 사용한다. 개인 연락처로 보이는 값은 남용 금지와 공개 원천 한계를 함께 둔다.

실패 모드

• 400: 도메인/IP/AS 형식 오류
• 503: 프록시에 DATA_GO_KR_API_KEY가 설정되지 않음
• 502 upstream_forbidden: data.go.kr가 키를 거부하거나 15094277 활용신청이 승인되지 않음
• upstream result_code가 10000이 아님: result_msg와 할당 여부 확인

출처

• 공공데이터포털 WHOIS 도메인/IP 정보 API: https://www.data.go.kr/data/15094277/openapi.do
• 공식 upstream: B551505/whois/domain_name, B551505/whois/ip_address, B551505/whois/as_number
• 프록시 엔드포인트 목록: k-skill 프록시 서버 가이드