KISA WHOIS OpenAPI

▶ WHOIS OpenAPI 사용안내

인터넷주소 검색 요청 URL(도메인 조회인 경우 국가도메인(.kr .한국)만 조회가 가능합니다)

http://whois.kisa.or.kr/openapi/whois.jsp?query=도메인이름&key=[발급받은키값]&answer=[xml, json]	예시(XML, JSON)
http://whois.kisa.or.kr/openapi/whois.jsp?query=IP주소&key=[발급받은키값]&answer=[xml, json]	예시(XML, JSON)

IP주소/AS번호 국가코드 검색 요청 URL

http://whois.kisa.or.kr/openapi/whois.jsp?query=AS번호&key=[발급받은키값]&answer=[xml, json]	예시(XML, JSON)
http://whois.kisa.or.kr/openapi/ipascc.jsp?query=IP주소&key=[발급받은키값]&answer=[xml, json]	예시(XML, JSON)

요청 변수

요청 변수	값	설명
key	String (필수)	이용 등록을 통해 받은 key 스트링을 입력합니다.
query	String (필수)	조회 할 [도메인 이름, IP주소, AS번호]를 입력합니다.
answer	String (선택)	응답 형식[xml, json]을 입력합니다.(입력하지 않을 경우 xml)

요청 URL (Request URL) :  http://whois.kisa.or.kr/openapi/whois.jsp?query=[도메인이름, IP주소, AS번호]&key=[발급받은키값]&answer=[xml, json]  IP/AS 국가코드 요청 URL(Request URL for IP/AS Country Code) IP주소(IPv4, IPv6) 혹은 AS번호에 대한 국가코드 조회만을 제공하기위한 OpenAPI 서비스 URL입니다. :  http://whois.kisa.or.kr/openapi/ipascc.jsp?query=[IP주소, AS번호]&key=[발급받은키값]&answer=[xml, json]

요청 변수 (Request Parameter) 요청변수 값 설 명 key String (필수) 이용 등록을 통해 받은 KEY 스트링을 입력합니다. query String (필수) 조회 할 [도메인 이름, IP주소, AS번호]를 입력합니다. answer String (선택) 응답 형식[xml, json]을 입력합니다. (입력하지 않을 경우 xml)

출력 결과 필드 (Response Field) 도메인 필드 설 명 name 조회 대상 도메인 이름을 나타내는 String value로 갖고, domain 이름 최대값에 따른 제약을 받는다. regName 등록자 이름(한글)을 value로 갖는다. addr 등록인의 주소를 value로 갖는다. adminName 책임자 이름(한글)을 value로 갖는다. adminEmail 책임자의 E-Mail 정보를 value로 갖는다. adminPhone 책임자의 전화번호 정보를 value로 갖는다. regDate 도메인 등록일자를 (Date 형식) value로 갖는다. lastUpdatedDate 조회 대상 도메인의 최근 정보변경 일자를 value로 갖는다. endDate 조회 대상 도메인의 사용종료일자를 value로 갖는다. infoYN 도메인 정보공개 여부 Flag 값('Y','N')을 value로 갖는다. agency 등록대행자 이름을 value로 갖는다. agency_url 등록대행자 홈페이지 url 정보를 value로 갖는다. e_regName 등록자 이름(영문)을 value로 갖는다. e_addr 등록인의 주소(영문)을 value로 갖는다. e_agencyName 책임자 이름(영문)을 value로 갖는다. e_agency 등록대행자 이름(영문)을 value로 갖는다. ns1 1차네임서버정보 : 호스트 이름 ip1 1차네임서버정보 : IP 주소 ns2 2차네임서버정보 : 호스트이름 ip2 2차네임서버정보 : IP 주소 IP주소 필드 설 명 ISP IP주소 보유 기관 구분 정보를 value로 갖는다 netInfo IP주소 사용기관정보를 value로 갖는다. 주소범위(range), 프리픽스(prefix), 네트워크이름(servName), 기관명(orgname), 주소(addr), 우편번호(zipCode), 할당내역 등록일(regDate) 필드 포함 techContact 네트워크 담당자 인물정보를 value로 갖는다. 담당자이름(name), 담당자연락처(phone), 담당자이메일(email) 필드 포함 user IP주소 이용기관 정보를 value로 갖는다. netInfo, techContact 필드 정보 포함 AS번호 필드 설 명 asn 조회한 AS번호를 value로 갖는다. asName 조회한 AS번호의 AS이름을 value로 갖는다. orgInfo AS번호 기관정보를 value로 갖는다. 기관명(name), 주소(addr), 우편번호(zipeCode) 필드 포함 techContact 담당자이름(name), 담당자연락처(phone), 담당자이메일(email)필드 포함

비고 에러메세지 메세지 코드번호 설 명 000 시스템 에러입니다. 010 쿼리요청 제한을 초과하였습니다. 011 잘못된 쿼리요청입니다. 020 발급받은 key 값을 입력 하세요. 021 등록되지 않는 key 입니다. 022 사용할 수 없는 key 입니다. 023 조회 거부되어 사용할 수 없는 key 입니다. 030 조회할 도메인 이름을 입력하세요. 031 본 조회는 조회 형식이 옳지 않습니다. 100 상기 도메인이름은 등록되어 있지 않습니다. 110 상기 도메인이름은 현재 등록이 제한되어 있습니다. 111 상기 도메인이름은 사전에 등록대상으로 정해진 기관이 신청할 수 있습니다. 900 정의되지 않은 오류가 발생하였습니다. 1NNNN 올바르지 않은 질의에 의한 서버측 오류 9NNNN 서버측 처리 오류